SmtpClient.SendMailAsync メソッド

定義

名前空間:

System.Net.Mail

アセンブリ:

System.Net.Mail.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

非同期操作として、指定したメッセージを配信用 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 をアドバタイズしませんでした。

- または -

To、CC、または Bcc 内の 1 人以上の受信者に、message を配信できませんでした。

SmtpFailedRecipientException

To、CC、または Bcc 内の 1 人の受信者に、message を配信できませんでした。

SmtpFailedRecipientsException

To、CC、または Bcc 内の複数の受信者に、message を配信できませんでした。

注釈

この操作はブロックされません。 返された Task オブジェクトは、メッセージが送信されると完了します。

SendMailAsync(MailMessage, CancellationToken)

ソース:

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 をアドバタイズしませんでした。

- または -

To、CC、または Bcc 内の 1 人以上の受信者に、message を配信できませんでした。

SmtpFailedRecipientException

To、CC、または Bcc 内の 1 人の受信者に、message を配信できませんでした。

SmtpFailedRecipientsException

To、CC、または Bcc 内の複数の受信者に、message を配信できませんでした。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

この操作はブロックされません。 返された Task オブジェクトは、メッセージが送信されると完了します。

SendMailAsync(String, String, String, String)

ソース:

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);

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 をアドバタイズしませんでした。

- または -

To、CC、または Bcc 内の 1 人以上の受信者に、message を配信できませんでした。

SmtpFailedRecipientException

To、CC、または Bcc 内の 1 人の受信者に、message を配信できませんでした。

SmtpFailedRecipientsException

To、CC、または Bcc 内の複数の受信者に、message を配信できませんでした。

注釈

この操作はブロックされません。 返された Task オブジェクトは、メッセージが送信されると完了します。

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

ソース:

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 をアドバタイズしませんでした。

- または -

To、CC、または Bcc 内の 1 人以上の受信者に、message を配信できませんでした。

SmtpFailedRecipientException

To、CC、または Bcc 内の 1 人の受信者に、message を配信できませんでした。

SmtpFailedRecipientsException

To、CC、または Bcc 内の複数の受信者に、message を配信できませんでした。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

この操作はブロックされません。 返された Task オブジェクトは、メッセージが送信されると完了します。