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)

ソース:: SmtpClient.cs

ソース:: SmtpClient.cs

ソース:: 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 property は Network に設定され、 Host は空の文字列 ("") と等しくなります。

-又は-

DeliveryMethod プロパティが Network に設定され、 Port が 0、負の数、または 65,535 を超える。

ObjectDisposedException

このオブジェクトは破棄されました。

SmtpException

SMTP サーバーへの接続に失敗しました。

-又は-

認証に失敗した。

-又は-

操作がタイムアウトしたとき。

-又は-

EnableSsl は true に設定されていますが、 DeliveryMethod プロパティは SpecifiedPickupDirectory または PickupDirectoryFromIis に設定されます。

-又は-

EnableSsl は true, に設定されていますが、SMTP メールサーバーが EHLO コマンドへの応答で STARTTLS をアドバタイズしませんでした。

-又は-

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

SmtpFailedRecipientException

messageを、To、CC、またはBccのいずれかの受信者に配信できませんでした。

SmtpFailedRecipientsException

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

注釈

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

適用対象

SendMailAsync(MailMessage, CancellationToken)

ソース:: SmtpClient.cs

ソース:: SmtpClient.cs

ソース:: 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 property は Network に設定され、 Host は空の文字列 ("") と等しくなります。

-又は-

DeliveryMethod プロパティが Network に設定され、 Port が 0、負の数、または 65,535 を超える。

ObjectDisposedException

このオブジェクトは破棄されました。

SmtpException

SMTP サーバーへの接続に失敗しました。

-又は-

認証に失敗した。

-又は-

操作がタイムアウトしたとき。

-又は-

EnableSsl は true に設定されていますが、 DeliveryMethod プロパティは SpecifiedPickupDirectory または PickupDirectoryFromIis に設定されます。

-又は-

EnableSsl は true, に設定されていますが、SMTP メールサーバーが EHLO コマンドへの応答で STARTTLS をアドバタイズしませんでした。

-又は-

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

SmtpFailedRecipientException

messageを、To、CC、またはBccのいずれかの受信者に配信できませんでした。

SmtpFailedRecipientsException

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

OperationCanceledException

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

注釈

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

適用対象

SendMailAsync(String, String, String, String)

ソース:: SmtpClient.cs

ソース:: SmtpClient.cs

ソース:: 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 property は Network に設定され、 Host は空の文字列 ("") と等しくなります。

-又は-

DeliveryMethod プロパティが Network に設定され、 Port が 0、負の数、または 65,535 を超える。

ObjectDisposedException

このオブジェクトは破棄されました。

SmtpException

SMTP サーバーへの接続に失敗しました。

-又は-

認証に失敗した。

-又は-

操作がタイムアウトしたとき。

-又は-

EnableSsl は true に設定されていますが、 DeliveryMethod プロパティは SpecifiedPickupDirectory または PickupDirectoryFromIis に設定されます。

-又は-

EnableSsl は true, に設定されていますが、SMTP メールサーバーが EHLO コマンドへの応答で STARTTLS をアドバタイズしませんでした。

-又は-

メッセージを、 To、 CC、または Bccの 1 つ以上の受信者に配信できませんでした。

SmtpFailedRecipientException

メッセージを、 To、 CC、または Bccのいずれかの受信者に配信できませんでした。

SmtpFailedRecipientsException

メッセージを、 To、 CC、または Bccの複数の受信者に配信できませんでした。

注釈

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

適用対象

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

ソース:: SmtpClient.cs

ソース:: SmtpClient.cs

ソース:: 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