SmtpClient.SendMailAsync 方法

參考

定義

命名空間:: System.Net.Mail

組件:: 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)

來源:: 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 為零、負數或大於 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)

來源:: 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 為零、負數或大於 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)

來源:: 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 為零、負數或大於 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(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 為零、負數或大於 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 的物件會在傳送訊息之後完成。

適用於

共用方式為

SmtpClient.SendMailAsync 方法

定義

多載

SendMailAsync(MailMessage)

參數

傳回

例外狀況

備註

適用於

SendMailAsync(MailMessage, CancellationToken)

參數

傳回

例外狀況

備註

適用於

SendMailAsync(String, String, String, String)

參數

傳回

例外狀況

備註

適用於

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

參數

傳回

例外狀況

備註

適用於

其他資源