Объектная модель > Основные механизмы > Mail – работа с почтовым сервером

В системе Directum RX предусмотрена отправка писем на SMTP-сервер.

Для программной работы с почтовым сервером предназначен класс Sungero.Core.Mail. Свойства и метода класса позволяют:

Чтобы обработать ошибки, связанные с работой почты, применяется класс Sungero.Core.MailException.

Методы

Имя	Описание
СreateMailMessage()	Создать письмо
Send() + 2 перегрузки	Отправить письмо, письма

IMailAttachment – вложение письма

Методы

Имя	Описание
AddAttachment() + 2 перегрузки	Добавить вложение

Свойства (для письма)

Имя	Тип	Описание
Bcc	ICollection<string>	Список получателей скрытой копии письма
Body	string	Текст письма
CC	ICollection<string>	Список получателей копии письма
From	string	Адрес отправителя, который указывается в почтовой рассылке. Например, support@company.ru Важно. С помощью свойства можно настроить только отображаемый адрес отправителя. Сам адрес, используемый для взаимодействия с почтовым сервером, и фактический адрес отправителя можно поменять только в параметре SMTP_FROM конфигурационного файла config.yml
FromDisplayName	string	Имя отправителя, которое указывается в почтовой рассылке. Например, «Служба поддержки». Заполните это свойство, чтобы вместо адреса отправителя отображалась другая подпись, а также если не подходит имя отправителя, указанное в параметре SMTP_FROM_DISPLAY_NAME конфигурационного файла config.yml
IsBodyHtml	bool	Признак того, что текст письма имеет формат HTML
Priority	MailProirity	Важность письма
Subject	string	Тема письма
To	ICollection<string>	Список адресатов письма

Свойства (для вложения письма)

Имя	Тип	Описание
ContentId	string	Идентификатор вложения письма
ContentStream	Stream	Поток вложения. Заполняется, если во вложении передается не версия электронного документа из системы, а сторонний файл в любом формате. Например, это может быть сторонний TXT-файл
IsInline	bool	Признак того, что вложение находится в тексте письма
MediaType	string	Тип мультимедиа, которое содержится во вложении письма
Name	string	Название вложения

Перечисления

Имя	Описание
MailPriority	Важность письма. Возможные значения: •High – высокая (2); •Low – низкая (1); •Normal – обычная (0)

Имя

Описание

MailPriority

Важность письма. Возможные значения:

•High – высокая (2);

•Low – низкая (1);

•Normal – обычная (0)

Пример. Создание письма, текст которого имеет HTML-формат

// Создать пустое письмо.
var message = Mail.CreateMailMessage();
// Заполнить тему письма.
message.Subject = "Макет нового логотипа сервиса";
// Наполнить письмо содержимым.
message.Body = @"<html>
                      <body>
                          <div style='color: red'>Макет нового логотипа сервиса</div>
                          <img border='0' height='25' src='cid:logo' />
                      </body>
                 </html>";
// Указать, что текст письма имеет формат HTML.
message.IsBodyHtml = true;
// Указать важность письма.
message.Priority = MailPriority.High;
// Указать адресатов письма.
message.To.Add("Ivanov_II@company.org");
message.To.Add("Petrov_VV@company.org");
// Указать получателей копии письма.
message.CC.Add("Sidorov_AA@company");
message.CC.Add("Aleksandrov_PV@company.org");
// Указать получателей скрытой копии письма.
message.Bcc.Add("Solovieva_AV@company.org");
message.Bcc.Add("Galchuk_NV@company.org");
// Указать имя отправителя.
message.FromDisplayName = "Служба поддержки";