SmtpClient.SendMailAsync 方法

定义

命名空间:: System.Net.Mail

程序集:: netstandard.dll, System.Net.Mail.dll

程序集:: System.Net.Mail.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将指定的消息作为异步操作发送到 SMTP 服务器进行传递。

重载

名称	说明
SendMailAsync(MailMessage)	将指定的消息作为异步操作发送到 SMTP 服务器进行传递。
SendMailAsync(MailMessage, CancellationToken)	将指定的消息作为异步操作发送到 SMTP 服务器进行传递。
SendMailAsync(String, String, String, String)	将指定的消息作为异步操作发送到 SMTP 服务器进行传递。使用对象指定 String 邮件发件人、收件人、主题和邮件正文。
SendMailAsync(String, String, String, String, CancellationToken)	使用指定的发件人、收件人、主题和正文字符串将指定邮件作为异步操作发送到 SMTP 服务器进行传递。

SendMailAsync(MailMessage)

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: 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

包含要发送的消息的 A MailMessage 。

Task

表示异步操作的任务对象。

例外

ArgumentNullException

message 是 null。

InvalidOperationException

此操作 SmtpClient 还有另一个正在进行中的发送操作。

-或-

没有在和属性中指定的To CC Bcc收件人。

-或-

DeliveryMethod 属性设置为 Network 和 Host is null。

-或-

DeliveryMethod 属性设置为 Network 空字符串（ Host “”）

-或-

DeliveryMethod 属性设置为 Network 零， Port 负数或大于 65,535。

ObjectDisposedException

此对象已被释放。

SmtpException

与 SMTP 服务器的连接失败。

-或-

身份验证失败。

-或-

操作超时。

-或-

EnableSsl 设置为 true ，但属性 DeliveryMethod 设置为 SpecifiedPickupDirectory 或 PickupDirectoryFromIis。

-或-

EnableSsl 设置为 true, SMTP 邮件服务器未在响应 EHLO 命令时播发 STARTTLS。

-或-

无法将邮件message传递到一个或多个收件人，To CC或者Bcc。

SmtpFailedRecipientException

无法将邮件 message 传递到其中 To一个收件人， CC或者 Bcc。

SmtpFailedRecipientsException

message无法向两个或更多收件人To送达，CC或者Bcc。

注解

此操作不会阻止。发送消息后，返回 Task 的对象将完成。

适用于

SendMailAsync(MailMessage, CancellationToken)

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: 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 is null。

-或-

DeliveryMethod 属性设置为 Network 空字符串（ Host “”）

-或-

DeliveryMethod 属性设置为 Network 零， Port 负数或大于 65,535。

ObjectDisposedException

此对象已被释放。

SmtpException

与 SMTP 服务器的连接失败。

-或-

身份验证失败。

-或-

操作超时。

-或-

EnableSsl 设置为 true ，但属性 DeliveryMethod 设置为 SpecifiedPickupDirectory 或 PickupDirectoryFromIis。

-或-

EnableSsl 设置为 true, SMTP 邮件服务器未在响应 EHLO 命令时播发 STARTTLS。

-或-

无法将邮件message传递到一个或多个收件人，To CC或者Bcc。

SmtpFailedRecipientException

无法将邮件 message 传递到其中 To一个收件人， CC或者 Bcc。

SmtpFailedRecipientsException

message无法向两个或更多收件人To送达，CC或者Bcc。

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

注解

此操作不会阻止。发送消息后，返回 Task 的对象将完成。

适用于

SendMailAsync(String, String, String, String)

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: 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

包含消息发送到的地址的 A String 。

subject: String

包含邮件的主题行的 A String 。

body: String

包含消息正文的 A String 。

Task

表示异步操作的任务对象。

例外

ArgumentNullException

from 是 null。

-或-

recipients 是 null。

ArgumentException

from 是 Empty。

-或-

recipients 是 Empty。

InvalidOperationException

此操作 SmtpClient 还有另一个正在进行中的发送操作。

-或-

From 是 null。

-或-

DeliveryMethod 属性设置为 Network 和 Host is null。

-或-

DeliveryMethod 属性设置为 Network 空字符串（ Host “”）

-或-

DeliveryMethod 属性设置为 Network 零， Port 负数或大于 65,535。

ObjectDisposedException

此对象已被释放。

SmtpException

与 SMTP 服务器的连接失败。

-或-

身份验证失败。

-或-

操作超时。

-或-

EnableSsl 设置为 true ，但属性 DeliveryMethod 设置为 SpecifiedPickupDirectory 或 PickupDirectoryFromIis。

-或-

EnableSsl 设置为 true, SMTP 邮件服务器未在响应 EHLO 命令时播发 STARTTLS。

-或-

邮件无法传递到一个或多个收件人，To CC或者Bcc。

SmtpFailedRecipientException

无法将邮件传递到其中 To一个收件人， CC或者 Bcc。

SmtpFailedRecipientsException

邮件无法传递到两个或更多收件人，To CC或者Bcc。

注解

此操作不会阻止。发送消息后，返回 Task 的对象将完成。

适用于

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

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: 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