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.TaskPublic 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.
Комментарии
Эта операция не блокируется. Возвращенный 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.TaskPublic 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.
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Эта операция не блокируется. Возвращенный 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.TaskPublic Function SendMailAsync (from As String, recipients As String, subject As String, body As String) As TaskПараметры
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
В этом 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.
Комментарии
Эта операция не блокируется. Возвращенный 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.TaskPublic 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
Токен отмены для отмены операции.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
В этом 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.
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Эта операция не блокируется. Возвращенный Task объект завершится после отправки сообщения.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по