SmtpClient.Send

.NET Framework クラス ライブラリ リファレンス

SmtpClient.Send メソッド (String, String, String, String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した電子メール メッセージを、配信用 SMTP サーバーに送信します。メッセージの差出人、受信者、件名、およびメッセージ本文は、String オブジェクトを使用して指定されます。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Send ( _
    from As String, _
    recipients As String, _
    subject As String, _
    body As String _
)

Visual Basic (使用法)

Dim instance As SmtpClient
Dim from As String
Dim recipients As String
Dim subject As String
Dim body As String

instance.Send(from, recipients, subject, body)

C#

public void Send (
    string from,
    string recipients,
    string subject,
    string body
)

C++

public:
void Send (
    String^ from, 
    String^ recipients, 
    String^ subject, 
    String^ body
)

J#

public void Send (
    String from, 
    String recipients, 
    String subject, 
    String body
)

JScript

public function Send (
    from : String, 
    recipients : String, 
    subject : String, 
    body : String
)

パラメータ

from

メッセージの差出人のアドレス情報を格納している String。

recipients

メッセージの送信先のアドレスを格納している String。

subject

メッセージの件名を格納している String。

body

メッセージ本文を格納している String。

例外

例外の種類	条件
ArgumentNullException	from が null 参照 (Visual Basic では Nothing) です。 または recipient が null 参照 (Visual Basic では Nothing) です。
ArgumentException	from が Empty です。 または recipient が Empty です。
InvalidOperationException	この SmtpClient は、SendAsync の呼び出し中です。 または Host が null 参照 (Visual Basic では Nothing) です。 または Host が空の文字列 ("") です。 または、Port が 0 です。
ObjectDisposedException	このオブジェクトは破棄されています。
SmtpException	SMTP サーバーへの接続に失敗しました。 または 認証に失敗しました。 または 操作がタイムアウトしました。
SmtpFailedRecipientsException	recipients 内の 1 人以上の受信者に、メッセージを配信できませんでした。

解説

このメソッドは、電子メールの送信中はブロックします。Timeout プロパティを使用してタイムアウト値を指定すると、指定した時間の経過後にメソッドから制御を戻すことができます。

このメソッドを呼び出す前に、構成ファイルを使用して関連するプロパティを設定するか、またはこの情報を SmtpClient(String,Int32) コンストラクタに渡して、Host プロパティと Port プロパティを設定する必要があります。

非同期的に送信中のメッセージが存在する場合、このメソッドは呼び出すことができません。

SMTP ホストが資格情報を要求する場合、このメソッドを呼び出す前にこれらを設定する必要があります。資格情報を指定するには、UseDefaultCredentials プロパティまたは Credentials プロパティを使用します。

SmtpException 例外が発生した場合は、StatusCode プロパティをチェックして操作が失敗した理由を確認してください。SmtpException は、操作が失敗した理由を示す内部例外を格納することもできます。

.NET Framework のセキュリティ

• SmtpPermission  (SMTP サーバーに接続するために必要な許可)Connect (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpClient クラス
SmtpClient メンバ
System.Net.Mail 名前空間

SmtpClient.Send メソッド (MailMessage)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したメッセージを、配信用 SMTP サーバーに送信します。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Send ( _
    message As MailMessage _
)

Visual Basic (使用法)

Dim instance As SmtpClient
Dim message As MailMessage

instance.Send(message)

C#

public void Send (
    MailMessage message
)

C++

public:
void Send (
    MailMessage^ message
)

J#

public void Send (
    MailMessage message
)

JScript

public function Send (
    message : MailMessage
)

パラメータ

message

送信するメッセージを格納した MailMessage。

例外

例外の種類	条件
ArgumentNullException	From が null 参照 (Visual Basic では Nothing) です。 または To が null 参照 (Visual Basic では Nothing) です。 または message が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	To、CC、および BCC に受信者が指定されていません。
InvalidOperationException	この SmtpClient は、SendAsync の呼び出し中です。 または Host が null 参照 (Visual Basic では Nothing) です。 または Host が空の文字列 ("") です。 または、Port が 0 です。
ObjectDisposedException	このオブジェクトは破棄されています。
SmtpException	SMTP サーバーへの接続に失敗しました。 または 認証に失敗しました。 または 操作がタイムアウトしました。
SmtpFailedRecipientsException	To、CC、またはBCC 内の 1 人以上の受信者に、メッセージを配信できませんでした。

解説

このメソッドは、電子メールの送信中はブロックします。Timeout プロパティを使用してタイムアウト値を指定すると、指定した時間の経過後にメソッドから制御を戻すことができます。

このメソッドを呼び出す前に、構成ファイルを使用して関連するプロパティを設定するか、またはこの情報を SmtpClient(String,Int32) コンストラクタに渡して、Host メソッドと Port メソッドを設定する必要があります。

非同期的に送信中のメッセージが存在する場合、このメソッドは呼び出すことができません。

SMTP ホストが資格情報を要求する場合、このメソッドを呼び出す前にこれらを設定する必要があります。資格情報を指定するには、UseDefaultCredentials プロパティまたは Credentials プロパティを使用します。

SmtpException 例外が発生した場合は、StatusCode プロパティをチェックして操作が失敗した理由を確認してください。SmtpException は、操作が失敗した理由を示す内部例外を格納することもできます。

使用例

このメソッドを使用するコード例を次に示します。

C#

public static void CreateTestMessage2(string
 server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature,
 you can send an e-mail message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client 
    // to authenticate before it will send e-mail on the client's behalf.
    client.UseDefaultCredentials = true;
    client.Send(message);
}

.NET Framework のセキュリティ

• SmtpPermission  (SMTP サーバーに接続するために必要な許可)Connect (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpClient クラス
SmtpClient メンバ
System.Net.Mail 名前空間

SmtpClient.Send メソッド

電子メール メッセージを、配信用 SMTP サーバーに送信します。これらのメソッドは、メッセージの送信中はブロックします。
オーバーロードの一覧

名前	説明
SmtpClient.Send (MailMessage)	指定したメッセージを、配信用 SMTP サーバーに送信します。
SmtpClient.Send (String, String, String, String)	指定した電子メール メッセージを、配信用 SMTP サーバーに送信します。メッセージの差出人、受信者、件名、およびメッセージ本文は、String オブジェクトを使用して指定されます。

参照

関連項目

SmtpClient クラス
SmtpClient メンバ
System.Net.Mail 名前空間