SmtpClient.SendMailAsync Метод

Ссылка

Определение

Пространство имен:: System.Net.Mail

Сборка:: System.Net.Mail.dll

Сборка:: System.dll

Сборка:: netstandard.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

Исходный код:: 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, который содержит отправляемое сообщение.

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

Task

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

-или-

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

-или-

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

-или-

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

-или-

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

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.

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

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

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

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

Task

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

-или-

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

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

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, содержащее основную часть сообщения.

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

Task

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

Исключения

ArgumentNullException

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

-или-

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

ArgumentException

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

-или-

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

InvalidOperationException

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

-или-

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

-или-

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

-или-

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

-или-

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

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.

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

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

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

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

Task

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

Исключения

ArgumentNullException

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

-или-

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

ArgumentException

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

-или-

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

InvalidOperationException

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

-или-

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

-или-

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

-или-

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

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

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

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

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

SmtpClient.SendMailAsync Метод

Определение

Перегрузки

SendMailAsync(MailMessage)

Параметры

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

Исключения

Комментарии

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

SendMailAsync(MailMessage, CancellationToken)

Параметры

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

Исключения

Комментарии

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

SendMailAsync(String, String, String, String)

Параметры

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

Исключения

Комментарии

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

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

Параметры

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

Исключения

Комментарии

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

Дополнительные ресурсы