Send(MailMessage) メソッド

MailMessageをメールサーバーに送信します。

シンタックス

Visual Basic (宣言)
C#

public SmtpResult Send( 
   MailMessage message
)

Public Overloads Function Send( _
   ByVal message As MailMessage _
) As SmtpResult

パラメータ

message: 電子メールメッセージを表すMailMessage。

戻り値の型

結果を表すSmtpResult。

例外

例外	解説
ProtocolException	サーバーから受信したSMTPプロトコル応答が不良です。
System.Net.Sockets.SocketException	ソケットエラー。
System.InvalidOperationException	MailMessage.BitEncoding が TransferEncoding.EightBit または TransferEncoding.Binary ですが、サーバーが8ビットまたはバイナリの転送をサポートしているか不明です。
System.FormatException	アドレス形式が正しくありません。

解説

このメソッドは、ほとんどの電子メールメッセージの送信に使用されます。MailMessageは以下のように初期化します。

MailMessage.MailMessage コンストラクタを使用して新しいMailMessageを作成します。
From、To、Cc、Bcc、Subjectを使用して、送信者、受信者、および件名を設定します。
MIMEパートを表す新しいPartオブジェクトをPartsに追加します。

この他に、Send(String,String,String,String)を使用して基本的なテキストメッセージを送信する方法や、Send(MailMessage,String,String)を使用してメッセージエンベロープのメールアドレスを指定する方法、Send(Stream,String,String)を使用して事前にエンコードされたメッセージ（ストリーム）を送信する方法もあります。

SendDirectToMxがfalseで、なおかつサーバーに接続していない場合、このメソッドは自動的にConnectとAuthenticateを呼び出します。

使用例

Smtpコンポーネントを使用して、添付ファイルの付いたテキストメッセージを送信します。

private void sendMail(object sender)
{
    // 送信するメッセージを作成します。
    MailMessage message = new MailMessage();
    message.To = toAddress;
    message.From = fromAddress;
    message.Subject = "File Attached";
    message.Text = "Please see the attached file.";

    // 添付ファイルを追加します。
    message.Attachments.Add(new Attachment(Application.StartupPath + "\\myImage.jpg"));

    // セッションパラメーターを設定します。
    smtp1.Session.RemoteEndPoint = 
        new Dart.Mail.IPEndPoint(myMailServer, Smtp.GetDefaultPort(smtp1.Session));
    smtp1.Session.Username = myUsername;
    smtp1.Session.Password = myPassword;

    // メッセージを送信します。
    smtp1.Send(message);

    // 適切にログアウトします。
    smtp1.Close();
}

private void smtp1_Progress(object sender, SmtpProgressEventArgs e)
{
    // メッセージの送信状況に従ってプログレスバーを更新します。
    progressBar1.Value = (e.Final) ? 0 : (int)((e.Position * 100) / e.Length);
}

Visual Basic

Private Sub sendMail(ByVal sender As Object)
    ' 送信するメソッドを作成します。
    Dim message As New MailMessage()
    message.To = toAddress
    message.From = fromAddress
    message.Subject = "File Attached"
    message.Text = "Please see the attached file."

    ' 添付ファイルを追加します。
    message.Attachments.Add(New Attachment(Application.StartupPath & "\myImage.jpg"))

    ' セッションパラメーターを設定します。
    smtp1.Session.RemoteEndPoint = New Dart.Mail.IPEndPoint(myMailServer, Smtp.GetDefaultPort(smtp1.Session))
    smtp1.Session.Username = myUsername
    smtp1.Session.Password = myPassword

    ' メッセージを送信します。
    smtp1.Send(message)

    ' 適切にログアウトします。
    smtp1.Close()
End Sub

Private Sub smtp1_Progress(ByVal sender As Object, ByVal e As SmtpProgressEventArgs) Handles smtp1.Progress
    ' メッセージの送信状況に従ってプログレスバーを更新します。
    progressBar1.Value = If(e.Final, 0, CInt((e.Position * 100) \ e.Length))
End Sub

参照

Smtp クラス
 Smtp メンバ
 オーバーロード一覧