英語で読む

次の方法で共有


SmtpClient クラス

定義

アプリケーションが SMTP (簡易メール転送プロトコル) を使用して電子メールを送信できるようにします。 型は SmtpClient 一部のプラットフォームでは廃止されており、他のプラットフォームでは推奨されません。詳細については、「解説」セクションを参照してください。

public class SmtpClient : IDisposable
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public class SmtpClient : IDisposable
public class SmtpClient
継承
SmtpClient
属性
実装

次のコード例では、電子メール メッセージを非同期に送信する方法を示します。


using System;
using System.Net;
using System.Net.Mail;
using System.Net.Mime;
using System.Threading;
using System.ComponentModel;
namespace Examples.SmtpExamples.Async
{
    public class SimpleAsynchronousExample
    {
        static bool mailSent = false;
        private static void SendCompletedCallback(object sender, AsyncCompletedEventArgs e)
        {
            // Get the unique identifier for this asynchronous operation.
             String token = (string) e.UserState;

            if (e.Cancelled)
            {
                 Console.WriteLine("[{0}] Send canceled.", token);
            }
            if (e.Error != null)
            {
                 Console.WriteLine("[{0}] {1}", token, e.Error.ToString());
            } else
            {
                Console.WriteLine("Message sent.");
            }
            mailSent = true;
        }
        public static void Main(string[] args)
        {
            // Command-line argument must be the SMTP host.
            SmtpClient client = new SmtpClient(args[0]);
            // Specify the email sender.
            // Create a mailing address that includes a UTF8 character
            // in the display name.
            MailAddress from = new MailAddress("jane@contoso.com",
               "Jane " + (char)0xD8+ " Clayton",
            System.Text.Encoding.UTF8);
            // Set destinations for the email message.
            MailAddress to = new MailAddress("ben@contoso.com");
            // Specify the message content.
            MailMessage message = new MailMessage(from, to);
            message.Body = "This is a test email message sent by an application. ";
            // Include some non-ASCII characters in body and subject.
            string someArrows = new string(new char[] {'\u2190', '\u2191', '\u2192', '\u2193'});
            message.Body += Environment.NewLine + someArrows;
            message.BodyEncoding =  System.Text.Encoding.UTF8;
            message.Subject = "test message 1" + someArrows;
            message.SubjectEncoding = System.Text.Encoding.UTF8;
            // Set the method that is called back when the send operation ends.
            client.SendCompleted += new
            SendCompletedEventHandler(SendCompletedCallback);
            // The userState can be any object that allows your callback
            // method to identify this send operation.
            // For this example, the userToken is a string constant.
            string userState = "test message1";
            client.SendAsync(message, userState);
            Console.WriteLine("Sending message... press c to cancel mail. Press any other key to exit.");
            string answer = Console.ReadLine();
            // If the user canceled the send, and mail hasn't been sent yet,
            // then cancel the pending operation.
            if (answer.StartsWith("c") && mailSent == false)
            {
                client.SendAsyncCancel();
            }
            // Clean up.
            message.Dispose();
            Console.WriteLine("Goodbye.");
        }
    }
}

注釈

クラスは SmtpClient 、配信のために SMTP サーバーに電子メールを送信するために使用されます。 SMTP プロトコルは RFC 2821 で定義されています。これは で https://www.ietf.org使用できます。

重要

多くの最新のプロトコルを SmtpClient サポートしていないため、新しい開発 SmtpClient には クラスを使用しないことをお勧めします。 代わりに MailKit またはその他のライブラリを使用してください。 詳細については、「 SmtpClient を GitHub で使用しないでください」を参照してください。

クラスは SmtpClient Xamarin では使用されていません。 ただし

  • これは .NET Standard 2.0 以降のバージョンに含まれているため、これらのバージョンをサポートする .NET 実装の一部である必要があります。
  • これは存在し、.NET Framework 4 ~ .NET Framework 4.8 で使用できます。
  • .NET Core で使用できますが、その使用はお勧めしません。

次の表に示すクラスは、 を使用して送信できる電子メール メッセージを作成するために使用 SmtpClientされます。

クラス 説明
Attachment 添付ファイルを表します。 このクラスを使用すると、ファイル、ストリーム、またはテキストを電子メール メッセージに添付できます。
MailAddress 送信者と受信者のメール アドレスを表します。
MailMessage 電子メール メッセージを表します。

を使用 SmtpClientして電子メール メッセージを作成して送信するには、次の情報を指定する必要があります。

  • 電子メールの送信に使用する SMTP ホスト サーバー。 プロパティと Port プロパティをHost参照してください。

  • SMTP サーバーで必要な場合は、認証の資格情報。 Credentials プロパティをご覧ください。

  • 送信者の電子メール アドレス。 パラメーターを Send 受け取る メソッドと SendAsync メソッドを from 参照してください。 プロパティも参照してください MailMessage.From

  • 受信者のメール アドレスまたはアドレス。 パラメーターを Send 受け取る メソッドと SendAsync メソッドを recipient 参照してください。 プロパティも参照してください MailMessage.To

  • メッセージのコンテンツ。 パラメーターを Send 受け取る メソッドと SendAsync メソッドを body 参照してください。 プロパティも参照してください MailMessage.Body

電子メール メッセージに添付ファイルを含めるには、 クラスを使用 Attachment して添付ファイルを作成し、 プロパティを使用 MailMessage.Attachments してメッセージに追加します。 受信者が使用するメール リーダーと添付ファイルの種類によっては、一部の受信者が添付ファイルを読み取ることができない場合があります。 添付ファイルを元の形式で表示できないクライアントの場合は、 プロパティを使用して代替ビューを MailMessage.AlternateViews 指定できます。

.NET Frameworkでは、アプリケーションまたはマシン構成ファイルを使用して、すべてのSmtpClientオブジェクトの既定のホスト、ポート、資格情報の値を指定できます。 詳細については、「mailSettings> 要素 (ネットワーク設定)」を参照してください<。 .NET Core では、既定値の設定はサポートされていません。 回避策として、関連するプロパティを に直接設定する SmtpClient 必要があります。

SMTP サーバーに電子メールが送信されるのを待っている間に電子メール メッセージを送信してブロックするには、同期 Send メソッドのいずれかを使用します。 電子メールの送信中にプログラムのメイン スレッドが実行を続行できるようにするには、非同期SendAsyncメソッドのいずれかを使用します。 イベントは SendCompleted 、操作が SendAsync 完了したときに発生します。 このイベントを受信するには、 にデリゲートを SendCompletedEventHandler 追加する SendCompleted必要があります。 デリゲートは SendCompletedEventHandler 、イベントの通知を処理するコールバック メソッドを SendCompleted 参照する必要があります。 非同期メール送信を取り消すには、 メソッドを使用します SendAsyncCancel

注意

進行中の電子メール送信があり、またはもう一度を呼び出SendAsyncSendすと、 がInvalidOperationException表示されます。

クラスの現在の SmtpClient インスタンスによって確立された SMTP サーバーへの接続は、アプリケーションが同じ SMTP サーバーに複数のメッセージを送信する場合に再利用できます。 これは、認証または暗号化を使用して SMTP サーバーへの接続を確立する場合に特に便利です。 TLS セッションを認証して確立するプロセスは、負荷の高い操作になる可能性があります。 大量の電子メールを同じ SMTP サーバーに送信するときに、各メッセージの接続を再確立する必要がある場合は、パフォーマンスに大きな影響を与える可能性があります。 メールの状態の更新、ニュースレターの配布、または電子メール アラートを送信する大量の電子メール アプリケーションが多数あります。 また、多くの電子メール クライアント アプリケーションでは、ユーザーが SMTP サーバーへの接続が確立されたときに後で送信される多くの電子メール メッセージを作成できるオフライン モードをサポートしています。 電子メール クライアントでは、すべての SMTP メッセージを (インターネット サービス プロバイダーによって提供される) 特定の SMTP サーバーに送信し、その電子メールを他の SMTP サーバーに転送するのが一般的です。

クラス実装では SmtpClient 、SMTP 接続がプールされるため、同じサーバーへのすべてのメッセージの接続を再確立するオーバーヘッドを回避できます。 アプリケーションは、同じオブジェクトを再利用して、同じ SmtpClient SMTP サーバーと多数の異なる SMTP サーバーに多数の異なる電子メールを送信できます。 その結果、 オブジェクトを使用してアプリケーションがいつ終了し、クリーンアップされるかを SmtpClient 判断する方法はありません。

SMTP セッションが終了し、クライアントが接続を終了する場合は、サーバーに QUIT メッセージを送信して、送信するメッセージがなくなったことを示す必要があります。 これにより、サーバーはクライアントから接続に関連付けられているリソースを解放し、クライアントによって送信されたメッセージを処理できます。

クラスには SmtpClient メソッドがないため Finalize 、アプリケーションで を呼び出 Dispose してリソースを明示的に解放する必要があります。 メソッドは Dispose 、 プロパティで指定された SMTP サーバーへの確立されたすべての接続を Host 反復処理し、QUIT メッセージを送信し、TCP 接続を正常に終了します。 メソッドは Dispose 、 によって Socket 使用されるアンマネージド リソースも解放し、必要に応じてマネージド リソースを破棄します。

Dispose を使い終わったら SmtpClient を呼び出します。 Disposeメソッドによって、SmtpClient は使用不可の状態になります。 Dispose呼び出し後は、SmtpClientによって占有されていたメモリをガベージ コレクターがクリアできるよう、SmtpClient へのすべての参照を解放する必要があります。

コンストラクター

SmtpClient()

構成ファイルの設定を使用して SmtpClient クラスの新しいインスタンスを初期化します。

SmtpClient(String)

指定した SMTP サーバーを使用して電子メールを送信する SmtpClient クラスの新しいインスタンスを初期化します。

SmtpClient(String, Int32)

指定した SMTP サーバーとポートを使用して電子メールを送信する SmtpClient クラスのインスタンスを初期化します。

プロパティ

ClientCertificates

SSL (Secure Sockets Layer) 接続を確立するために使用する必要のある証明書を指定します。

Credentials

差出人の認証に使用する資格情報を取得または設定します。

DeliveryFormat

電子メールを送信するために SmtpClient によって使用される配信形式を取得または設定します。

DeliveryMethod

送信メッセージの処理方法を指定します。

EnableSsl

SmtpClient が、接続を暗号化するために SSL (Secure Sockets Layer) を使用するかどうかを指定します。

Host

SMTP トランザクションで使用されるホストの名前または IP アドレスを取得または設定します。

PickupDirectoryLocation

ローカルの SMTP サーバーによって処理される電子メール メッセージをアプリケーションが保存するフォルダーを取得または設定します。

Port

SMTP トランザクションで使用されるポートを取得または設定します。

ServicePoint

電子メール メッセージの送信に使用するネットワーク接続を取得します。

TargetName

拡張保護を使用するときの認証に使用するサービス プロバイダー名 (SPN: Service Provider Name) を取得または設定します。

Timeout

同期的な Send 呼び出しがタイムアウトになるまでの時間を指定する値を取得または設定します。

UseDefaultCredentials

Boolean が要求と共に送信されるかどうかを制御する DefaultCredentials 値を取得または設定します。

メソッド

Dispose()

QUIT メッセージを SMTP サーバーに送信し、TCP 接続を適切に終了して、SmtpClient クラスの現在のインスタンスで使用されているすべてのリソースを解放します。

Dispose(Boolean)

QUIT メッセージを SMTP サーバーに送信し、TCP 接続を適切に終了して、SmtpClient クラスの現在のインスタンスで使用されているすべてのリソースを解放します。オプションでマネージド リソースも破棄します。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnSendCompleted(AsyncCompletedEventArgs)

SendCompleted イベントを発生させます。

Send(MailMessage)

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

Send(String, String, String, String)

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

SendAsync(MailMessage, Object)

指定した電子メール メッセージを、配信用 SMTP サーバーに送信します。 このメソッドは、呼び出し元のスレッドをブロックしません。また、呼び出し元は、操作の完了時に呼び出されるメソッドにオブジェクトを渡すことができます。

SendAsync(String, String, String, String, Object)

電子メール メッセージを、配信用 SMTP サーバーに送信します。 メッセージの差出人、受信者、件名、およびメッセージ本文は、String オブジェクトを使用して指定されます。 このメソッドは、呼び出し元のスレッドをブロックしません。また、呼び出し元は、操作の完了時に呼び出されるメソッドにオブジェクトを渡すことができます。

SendAsyncCancel()

電子メール メッセージを送信する非同期操作をキャンセルします。

SendMailAsync(MailMessage)

非同期操作として、指定したメッセージを配信用 SMTP サーバーに送信します。

SendMailAsync(MailMessage, CancellationToken)

非同期操作として、指定したメッセージを配信用 SMTP サーバーに送信します。

SendMailAsync(String, String, String, String)

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

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

指定された差出人、受信者、件名、本文の文字列を使用し、非同期操作として、指定されたメッセージを配信のために SMTP サーバーに送信します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

イベント

SendCompleted

電子メールの非同期的な送信操作が完了した場合に発生します。

適用対象

製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

こちらもご覧ください