共用方式為


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.Task
Public Function SendMailAsync (message As MailMessage) As Task

參數

message
MailMessage

MailMessage,包含要傳送的訊息。

傳回

工作物件,表示非同步作業。

例外狀況

messagenull

SmtpClient 有另一個已在進行中的傳送作業。

-或-

ToCCBcc 屬性中沒有指定任何收件者。

-或-

DeliveryMethod 屬性設定為 Network,且 Hostnull

-或-

DeliveryMethod 屬性設為 Network,且 Host 等於空字串 ("")。

-或-

DeliveryMethod 屬性設定為 Network ,而且 Port 為零、負數或大於 65,535。

這個物件已經過處置。

與 SMTP 伺服器的連接失敗。

-或-

驗證失敗。

-或-

作業逾時。

-或-

EnableSsl 設定為 true,但 DeliveryMethod 屬性設定為 SpecifiedPickupDirectoryPickupDirectoryFromIis

-或-

EnableSsl 設為 true, 不過 SMTP 郵件伺服器並未在對 EHLO 命令的回應中通告 STARTTLS。

-或-

無法將 message 傳遞給 ToCCBcc 中的一個或多個收件者。

無法將 message 傳遞給 ToCCBcc 中的一個收件者。

無法將 message 傳遞給 ToCCBcc 中的兩個或多個收件者。

備註

這項作業不會封鎖。 傳回 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

用於取消作業的取消權杖。

傳回

工作物件,表示非同步作業。

例外狀況

messagenull

SmtpClient 有另一個已在進行中的傳送作業。

-或-

Fromnull

-或-

ToCCBcc 屬性中沒有指定任何收件者。

-或-

DeliveryMethod 屬性設定為 Network,且 Hostnull

-或-

DeliveryMethod 屬性設為 Network,且 Host 等於空字串 ("")。

-或-

DeliveryMethod 屬性設定為 Network ,而且 Port 為零、負數或大於 65,535。

這個物件已經過處置。

與 SMTP 伺服器的連接失敗。

-或-

驗證失敗。

-或-

作業逾時。

-或-

EnableSsl 設定為 true,但 DeliveryMethod 屬性設定為 SpecifiedPickupDirectoryPickupDirectoryFromIis

-或-

EnableSsl 設為 true, 不過 SMTP 郵件伺服器並未在對 EHLO 命令的回應中通告 STARTTLS。

-或-

無法將 message 傳遞給 ToCCBcc 中的一個或多個收件者。

無法將 message 傳遞給 ToCCBcc 中的一個收件者。

無法將 message 傳遞給 ToCCBcc 中的兩個或多個收件者。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回 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,包含訊息主體。

傳回

工作物件,表示非同步作業。

例外狀況

fromnull

-或-

recipientsnull

fromEmpty

-或-

recipientsEmpty

SmtpClient 有另一個已在進行中的傳送作業。

-或-

Fromnull

-或-

DeliveryMethod 屬性設定為 Network,且 Hostnull

-或-

DeliveryMethod 屬性設為 Network,且 Host 等於空字串 ("")。

-或-

DeliveryMethod 屬性設定為 Network ,而且 Port 為零、負數或大於 65,535。

這個物件已經過處置。

與 SMTP 伺服器的連接失敗。

-或-

驗證失敗。

-或-

作業逾時。

-或-

EnableSsl 設定為 true,但 DeliveryMethod 屬性設定為 SpecifiedPickupDirectoryPickupDirectoryFromIis

-或-

EnableSsl 設為 true, 不過 SMTP 郵件伺服器並未在對 EHLO 命令的回應中通告 STARTTLS。

-或-

無法將 message 傳遞給 ToCCBcc 中的一個或多個收件者。

無法將 message 傳遞給 ToCCBcc 中的一個收件者。

無法將 message 傳遞給 ToCCBcc 中的兩個或多個收件者。

備註

這項作業不會封鎖。 傳回 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

用於取消作業的取消權杖。

傳回

工作物件,表示非同步作業。

例外狀況

fromnull

-或-

recipientsnull

fromEmpty

-或-

recipientsEmpty

SmtpClient 有另一個已在進行中的傳送作業。

-或-

DeliveryMethod 屬性設定為 Network,且 Hostnull

-或-

DeliveryMethod 屬性設為 Network,且 Host 等於空字串 ("")。

-或-

DeliveryMethod 屬性設定為 Network ,而且 Port 為零、負數或大於 65,535。

這個物件已經過處置。

與 SMTP 伺服器的連接失敗。

-或-

驗證失敗。

-或-

作業逾時。

-或-

EnableSsl 設定為 true,但 DeliveryMethod 屬性設定為 SpecifiedPickupDirectoryPickupDirectoryFromIis

-或-

EnableSsl 設為 true, 不過 SMTP 郵件伺服器並未在對 EHLO 命令的回應中通告 STARTTLS。

-或-

無法將 message 傳遞給 ToCCBcc 中的一個或多個收件者。

無法將 message 傳遞給 ToCCBcc 中的一個收件者。

無法將 message 傳遞給 ToCCBcc 中的兩個或多個收件者。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回 Task 的物件會在傳送訊息之後完成。

適用於