Поделиться через


SmtpClient.SendMailAsync Метод

Определение

Отправляет указанное сообщение SMTP-серверу для доставки в качестве асинхронной операции.

Перегрузки

SendMailAsync(MailMessage)

Отправляет указанное сообщение SMTP-серверу для доставки в качестве асинхронной операции.

SendMailAsync(MailMessage, CancellationToken)

Отправляет указанное сообщение SMTP-серверу для доставки в качестве асинхронной операции.

SendMailAsync(String, String, String, String)

Отправляет указанное сообщение SMTP-серверу для доставки в качестве асинхронной операции. Отправитель, получатели, тема и основная часть сообщения указываются с помощью объектов String.

SendMailAsync(String, String, String, String, CancellationToken)

Отправляет указанное сообщение на SMTP-сервер для доставки в качестве асинхронной операции, используя указанные строки с темой и текстом, а также с данными об отправителе и получателях.

SendMailAsync(MailMessage)

Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs

Отправляет указанное сообщение SMTP-серверу для доставки в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::Net::Mail::MailMessage ^ message);
public System.Threading.Tasks.Task SendMailAsync (System.Net.Mail.MailMessage message);
member this.SendMailAsync : System.Net.Mail.MailMessage -> System.Threading.Tasks.Task
Public Function SendMailAsync (message As MailMessage) As Task

Параметры

message
MailMessage

Объект MailMessage, который содержит отправляемое сообщение.

Возвращаемое значение

Объект задачи, представляющий асинхронную операцию.

Исключения

message имеет значение null.

В этом SmtpClient случае уже выполняется другая операция отправки.

-или-

Отсутствуют получатели в свойствах To, CC и Bcc.

-или-

Свойству DeliveryMethod задано значение Network, а свойству Host задано значение null.

-или-

Свойству DeliveryMethod задано значение Network и Host равно пустой строке ("").

-или-

Свойство DeliveryMethod имеет значение Network, а свойство Port равно нулю, отрицательно или больше 65535.

Данный объект удален.

Сбой подключения к серверу SMTP.

-или-

Проверка подлинности не пройдена.

-или-

Истекло время ожидания для выполнения операции.

-или-

EnableSsl имеет значение true, а свойство DeliveryMethod имеет значение SpecifiedPickupDirectory или PickupDirectoryFromIis.

-или-

Свойство EnableSsl имеет значение true, однако почтовый SMTP-сервер не отправил STARTTLS в ответ на команду EHLO.

-или-

Сообщение message не удалось доставить одному или нескольким получателям To, CC или Bcc.

Сообщение message не удалось доставить одному из получателей To, CC или Bcc.

Сообщение message не удалось доставить двум или более получателям To, CC или Bcc.

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершится после отправки сообщения.

Применяется к

SendMailAsync(MailMessage, CancellationToken)

Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs

Отправляет указанное сообщение SMTP-серверу для доставки в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::Net::Mail::MailMessage ^ message, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task SendMailAsync (System.Net.Mail.MailMessage message, System.Threading.CancellationToken cancellationToken);
member this.SendMailAsync : System.Net.Mail.MailMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SendMailAsync (message As MailMessage, cancellationToken As CancellationToken) As Task

Параметры

message
MailMessage

Сообщение для отправки.

cancellationToken
CancellationToken

Токен отмены для отмены операции.

Возвращаемое значение

Объект задачи, представляющий асинхронную операцию.

Исключения

message имеет значение null.

В этом SmtpClient случае уже выполняется другая операция отправки.

-или-

From имеет значение null.

-или-

Отсутствуют получатели в свойствах To, CC и Bcc.

-или-

Свойству DeliveryMethod задано значение Network, а свойству Host задано значение null.

-или-

Свойству DeliveryMethod задано значение Network и Host равно пустой строке ("").

-или-

Свойство DeliveryMethod имеет значение Network, а свойство Port равно нулю, отрицательно или больше 65535.

Данный объект удален.

Сбой подключения к серверу SMTP.

-или-

Проверка подлинности не пройдена.

-или-

Истекло время ожидания для выполнения операции.

-или-

EnableSsl имеет значение true, а свойство DeliveryMethod имеет значение SpecifiedPickupDirectory или PickupDirectoryFromIis.

-или-

Свойство EnableSsl имеет значение true, однако почтовый SMTP-сервер не отправил STARTTLS в ответ на команду EHLO.

-или-

Сообщение message не удалось доставить одному или нескольким получателям To, CC или Bcc.

Сообщение message не удалось доставить одному из получателей To, CC или Bcc.

Сообщение message не удалось доставить двум или более получателям To, CC или Bcc.

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершится после отправки сообщения.

Применяется к

SendMailAsync(String, String, String, String)

Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs

Отправляет указанное сообщение SMTP-серверу для доставки в качестве асинхронной операции. Отправитель, получатели, тема и основная часть сообщения указываются с помощью объектов String.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body);
public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string? subject, string? body);
public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string subject, string body);
member this.SendMailAsync : string * string * string * string -> System.Threading.Tasks.Task
Public Function SendMailAsync (from As String, recipients As String, subject As String, body As String) As Task

Параметры

from
String

Значение String, содержащее информацию об адресе отправителя сообщения.

recipients
String

Значение String, содержащее адреса, по которым отправляется сообщение.

subject
String

Значение String, содержащее строку темы сообщения.

body
String

Значение String, содержащее основную часть сообщения.

Возвращаемое значение

Объект задачи, представляющий асинхронную операцию.

Исключения

from имеет значение null.

-или-

recipients имеет значение null.

from имеет значение Empty.

-или-

recipients имеет значение Empty.

В этом SmtpClient случае уже выполняется другая операция отправки.

-или-

From имеет значение null.

-или-

Свойству DeliveryMethod задано значение Network, а свойству Host задано значение null.

-или-

Свойству DeliveryMethod задано значение Network и Host равно пустой строке ("").

-или-

Свойство DeliveryMethod имеет значение Network, а свойство Port равно нулю, отрицательно или больше 65535.

Данный объект удален.

Сбой подключения к серверу SMTP.

-или-

Проверка подлинности не пройдена.

-или-

Истекло время ожидания для выполнения операции.

-или-

EnableSsl имеет значение true, а свойство DeliveryMethod имеет значение SpecifiedPickupDirectory или PickupDirectoryFromIis.

-или-

Свойство EnableSsl имеет значение true, однако почтовый SMTP-сервер не отправил STARTTLS в ответ на команду EHLO.

-или-

Сообщение message не удалось доставить одному или нескольким получателям To, CC или Bcc.

Сообщение message не удалось доставить одному из получателей To, CC или Bcc.

Сообщение message не удалось доставить двум или более получателям To, CC или Bcc.

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершится после отправки сообщения.

Применяется к

SendMailAsync(String, String, String, String, CancellationToken)

Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs
Исходный код:
SmtpClient.cs

Отправляет указанное сообщение на SMTP-сервер для доставки в качестве асинхронной операции, используя указанные строки с темой и текстом, а также с данными об отправителе и получателях.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string? subject, string? body, System.Threading.CancellationToken cancellationToken);
member this.SendMailAsync : string * string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SendMailAsync (from As String, recipients As String, subject As String, body As String, cancellationToken As CancellationToken) As Task

Параметры

from
String

Информация об адресе отправителя сообщения.

recipients
String

Адреса, по которым отправляется сообщение.

subject
String

Строка для темы сообщения.

body
String

Текст сообщения.

cancellationToken
CancellationToken

Токен отмены для отмены операции.

Возвращаемое значение

Объект задачи, представляющий асинхронную операцию.

Исключения

from имеет значение null.

-или-

recipients имеет значение null.

from имеет значение Empty.

-или-

recipients имеет значение Empty.

В этом SmtpClient случае уже выполняется другая операция отправки.

-или-

Свойству DeliveryMethod задано значение Network, а свойству Host задано значение null.

-или-

Свойству DeliveryMethod задано значение Network и Host равно пустой строке ("").

-или-

Свойство DeliveryMethod имеет значение Network, а свойство Port равно нулю, отрицательно или больше 65535.

Данный объект удален.

Сбой подключения к серверу SMTP.

-или-

Проверка подлинности не пройдена.

-или-

Истекло время ожидания для выполнения операции.

-или-

EnableSsl имеет значение true, а свойство DeliveryMethod имеет значение SpecifiedPickupDirectory или PickupDirectoryFromIis.

-или-

Свойство EnableSsl имеет значение true, однако почтовый SMTP-сервер не отправил STARTTLS в ответ на команду EHLO.

-или-

Сообщение message не удалось доставить одному или нескольким получателям To, CC или Bcc.

Сообщение message не удалось доставить одному из получателей To, CC или Bcc.

Сообщение message не удалось доставить двум или более получателям To, CC или Bcc.

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершится после отправки сообщения.

Применяется к