OMailMessage
LTools.Office.Model.OMailMessage — модель письма. Используется в элементах, работающих с почтами Outlook, Exchange, Lotus Notes.
Свойства модели
Примечание. Все свойства, начинающиеся со слова Send, а также свойство ReplyAll содержат только техническую информацию и не предназначены для пользователей. Это такие свойства, как: SendTo, SendСс, SendВсс, SendOnBehalf, ReplyAll.
| Свойство | Тип | Описание |
|---|---|---|
| ID | String | Идентификатор письма. Позволяет обратиться к конкретному сообщению по его ID. Получить ID можно при считывании писем соответствующими элементами Студии. Например, в результате Чтения почты получаем список писем, у каждого из которых есть свой ID |
| MailFormat | LTools.Office.Model.OMailMessage.MailFormats | Формат письма. Пример значения: HTML. Также может быть PLAIN (простой текст) или Rich Text (расширенный текст) |
| MessageType | LTools.Office.Model.OMailMessage.MailTypes | Только для Outlook. Тип письма. Пример значения: Message или Report (отчет о доставке) |
| From | String | От кого. Содержит адрес электронной почты отправителя. Пример: user@mail.ru |
| To | List<String> | Кому — список адресов получателей сообщения |
| Сс | List<String> | Список адресов получателей копии сообщения |
| Всс | List<String> | Список получателей скрытой копии сообщения |
| CreateDate | System.DateTime | Дата и время создания письма. Пример значения: 13.07.2023 18:21:25. Отсутствует в Lotus Notes |
| ReceiveDate | System.DateTime | Дата и время получения письма. Отсутствует в Lotus Notes |
| Subject | String | Тема письма |
| ConversationTopic | String | Только для Outlook. Тема для потока беседы. Беседа содержит все связанные сообщения в одной беседе с одинаковой строкой темы. Темой беседы обычно является тема первого сообщения электронной почты в потоке. Подробнее о беседах в Outlook см. здесь . При чтении письма в Outlook могут быть заполнены как Subject, так и ConversationTopic. Пример значений для отправленного письма: Subject — "Re: Отпуск", ConversationTopic — "Отпуск" |
| Body | String | Текст тела письма. В Exchange тело будет представлено только в HTML, в Outlook — может быть и в виде простого текста (PLAIN). Простой текст не поддерживает картинки, гиперссылки (вместо них будут обычные ссылки) и другие подобные элементы. Пример значения для PLAIN: "Текст\n". Если считывается беседа, то тело будет включать все письма беседы |
| HTMLBody | String | Текст тела письма в формате HTML |
| MessageProperties | LTools.Office.Model.OMailMessage.OMailProperties | Только для Outlook. Свойства письма. Отображаются, если в элементе Чтение почты установлен флаг Читать свойства. С помощью свойств письма можно узнать, например, отображаемое имя отправителя/получателя |
| Element | - | Представляет сообщение электронной почты. Тип данных зависит от используемой почты: для Exchange — это EmailMessage, для Outlook — это MailItem, для Lotus — это Domino.NotesDocument. Чтобы получить доступ к свойствам класса, требуется сначала вручную привести его к нужному типу. Подробнее см. в подразделе ниже |
| Attachments | List<LTools.Office.Model.OMailAttachment> | Вложения письма |
Детализация свойств
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.
Необходимо учитывать, что имя отправителя может и не отображаться — это зависит от настроек почтового сервера.