SmtpClient.SendMailAsync Метод

Определение

Пространство имен:

System.Net.Mail

Сборки:

netstandard.dll, System.Net.Mail.dll

Отправляет указанное сообщение на 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

Отправляет указанное сообщение на 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 содержащий сообщение для отправки.

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

Task

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

Исключения

ArgumentNullException

message равно null.

InvalidOperationException

Это SmtpClient еще одна операция отправки уже выполняется.

–или–

Нет получателей, указанных в To, CCи Bcc свойствах.

–или–

DeliveryMethod свойство имеет значение Network и Host имеет значение null.

–или–

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

–или–

DeliveryMethod свойство равно нулю NetworkPort , отрицательному числу или больше 65 535.

ObjectDisposedException

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

SmtpException

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

–или–

Сбой проверки подлинности.

–или–

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

–или–

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

–или–

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

–или–

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

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

Не message удалось передать в два или более получателей в To, CCили Bcc.

Комментарии

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

SendMailAsync(MailMessage, CancellationToken)

Исходный код:

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

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

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

Task

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

Исключения

ArgumentNullException

message равно null.

InvalidOperationException

Это SmtpClient еще одна операция отправки уже выполняется.

–или–

From равно null.

–или–

Нет получателей, указанных в To, CCи Bcc свойствах.

–или–

DeliveryMethod свойство имеет значение Network и Host имеет значение null.

–или–

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

–или–

DeliveryMethod свойство равно нулю NetworkPort , отрицательному числу или больше 65 535.

ObjectDisposedException

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

SmtpException

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

–или–

Сбой проверки подлинности.

–или–

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

–или–

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

–или–

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

–или–

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

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

Не message удалось передать в два или более получателей в To, CCили Bcc.

OperationCanceledException

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

Комментарии

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

SendMailAsync(String, String, String, String)

Исходный код:

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);

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 содержащий текст сообщения.

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

Task

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

Исключения

ArgumentNullException

from равно null.

–или–

recipients равно null.

ArgumentException

from равно Empty.

–или–

recipients равно Empty.

InvalidOperationException

Это SmtpClient еще одна операция отправки уже выполняется.

–или–

From равно null.

–или–

DeliveryMethod свойство имеет значение Network и Host имеет значение null.

–или–

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

–или–

DeliveryMethod свойство равно нулю NetworkPort , отрицательному числу или больше 65 535.

ObjectDisposedException

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

SmtpException

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

–или–

Сбой проверки подлинности.

–или–

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

–или–

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

–или–

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

–или–

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

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

Комментарии

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

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

Исходный код:

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

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

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

Task

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

Исключения

ArgumentNullException

from равно null.

–или–

recipients равно null.

ArgumentException

from равно Empty.

–или–

recipients равно Empty.

InvalidOperationException

Это SmtpClient еще одна операция отправки уже выполняется.

–или–

DeliveryMethod свойство имеет значение Network и Host имеет значение null.

–или–

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

–или–

DeliveryMethod свойство равно нулю NetworkPort , отрицательному числу или больше 65 535.

ObjectDisposedException

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

SmtpException

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

–или–

Сбой проверки подлинности.

–или–

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

–или–

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

–или–

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

–или–

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

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

OperationCanceledException

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

Комментарии

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