OMailMessage
LTools.Office.Model.OMailMessage - модель письма. Используется в элементах, работающих с почтами Outlook, Exchange, Lotus Notes.
Свойства модели
🔹 Примечание. Все свойства, начинающиеся со слова Send, а также свойство ReplyAll содержат только техническую информацию и не предназначены для пользователей. Это такие свойства, как: SendTo, SendСс, SendВсс, SendOnBehalf, ReplyAll.
| Свойство | Тип | Описание |
|---|---|---|
ID | String | Идентификатор письма. Позволяет обратиться к конкретному сообщению по его ID. Получить ID можно при считывании писем соответствующими элементами Студии. Например, в результате Чтения почты получаем список писем, у каждого из которых есть свой ID |
MailFormat | Формат письма. Пример значения: | |
MessageType | LTools.Office.Model.OMailMessage.MailTypes | Только для Outlook. Тип письма. Пример значения: |
From | String | От кого. Содержит адрес электронной почты отправителя. Пример: |
To | List<String> | Кому - список адресов получателей сообщения |
Сс | List<String> | Список адресов получателей копии сообщения |
Всс | List<String> | Список получателей скрытой копии сообщения |
CreateDate | Дата и время создания письма. Пример значения: | |
ReceiveDate | System.DateTime | Дата и время получения письма. Отсутствует в Lotus Notes |
Subject | String | Тема письма |
ConversationTopic | String | Только для Outlook. Тема для потока беседы. Беседа содержит все связанные сообщения в одной беседе с одинаковой строкой темы. Темой беседы обычно является тема первого сообщения электронной почты в потоке. Подробнее о беседах в Outlook см. здесь. При чтении письма в Outlook могут быть заполнены как Subject, так и ConversationTopic. Пример значений для отправленного письма: Subject - |
Body | String | Текст тела письма. В Exchange тело будет представлено только в HTML, в Outlook - может быть и в виде простого текста (PLAIN). Простой текст не поддерживает картинки, гиперссылки (вместо них будут обычные ссылки) и другие подобные элементы. Пример значения для PLAIN: |
HTMLBody | String | Текст тела письма в формате HTML |
MessageProperties | LTools.Office.Model.OMailMessage.OMailProperties | Только для Outlook. Свойства письма. Отображаются, если в элементе Чтение почты установлен флаг Читать свойства. С помощью свойств письма можно узнать, например, отображаемое имя отправителя/получателя |
Element | - | Представляет сообщение электронной почты. Тип данных зависит от используемой почты: для Exchange - это EmailMessage, для Outlook - это MailItem, для Lotus - это Domino.NotesDocument. Чтобы получить доступ к свойствам класса, требуется сначала вручную привести его к нужному типу. Подробнее см. в подразделе ниже |
Attachments | Вложения письма |
Детализация свойств
CreateDate
Свойства модели CreateDate/ReceiveDate имеет следующий набор свойств:
Пример получения дня месяца, когда было создано сообщение: var_list_mails[0].CreateDate.Day, где:
var_list_mails - это условное название переменной;
[0] - индекс письма, свойство которого хотим получить.
Если используется вывод результата через элемент Запись в журнал, не забудьте привести значение к строке. Пример результата: 13.
Element
Свойство Element представляет собой почтовое сообщение. Тип данных зависит от используемой почты:
для Exchange - это Microsoft.Exchange.WebServices.Data.EmailMessage;
для Outlook - это Microsoft.Office.Interop.Outlook.MailItem;
для Lotus - это Domino.NotesDocument.
Список свойств будет соответствовать классу сообщения.
‼️ Для того, чтобы получить значение какого-либо свойства Element, требуется вручную привести его к нужному классу.
Например, чтобы получить имя отправителя для сообщения Exchange, приведите его сначала к EmailMessage:
(var_list_mails[0].Element as Microsoft.Exchange.WebServices.Data.EmailMessage).Sender.
MessageProperties
Свойство модели MessageProperties (только Outlook) обладает следующим набором свойств:
Их описание можно найти в этом разделе, выбрав нужное название канонического свойства в левом меню.
Пример получения отображаемого имени отправителя: var_list_mails[0].MessageProperties.PR_SENDER_NAME.
Необходимо учитывать, что имя отправителя может и не отображаться - это зависит от настроек почтового сервера.
Last updated