SmtpClient.EnableSsl プロパティ

定義

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

public:
 property bool EnableSsl { bool get(); void set(bool value); };
public bool EnableSsl { get; set; }
member this.EnableSsl : bool with get, set
Public Property EnableSsl As Boolean

プロパティ値

SmtpClient が SSL を使用する場合は true。それ以外の場合は false。 既定値は、false です。

次のコード例では、SMTP サーバーとの SSL 接続を確立し、接続を使用して電子メールを送信します。

public static void CreateTestMessage(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 email 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 email on the client's behalf.
    client.UseDefaultCredentials = true;
                client.EnableSsl = true;
    client.Send(message);
}

注釈

プロパティは EnableSsl 、指定された SMTP メール サーバーへのアクセスに SSL を使用するかどうかを指定します。

このプロパティの既定値は、コンピューターまたはアプリケーション構成ファイルでも設定できます。 プロパティに加えられた変更は、 EnableSsl 構成ファイルの設定をオーバーライドします。

SmtpClient クラスでサポートされているのは、RFC 3207 で定義されている SMTP Service Extension for Secure SMTP over Transport Layer Security (トランスポート層セキュリティ経由の安全な SMTP のための SMTP サービス拡張) のみです。 このモードでは、暗号化されていないチャネルで SMTP セッションが始まり、その後クライアントからサーバーに STARTTLS コマンドが発行され、SSL を使用してセキュリティで保護された通信に切り替わります。 詳細については、インターネット技術標準化委員会 (IETF) によって公開されている RFC 3207 を参照してください。

代替の接続方法では、プロトコル コマンドが送信される前に、SSL セッションが事前に確立されます。 この接続方法は、SMTP/SSL、SMTP over SSL、または SMTPS と呼ばれることもあります。既定ではポート 465 が使用されます。 SSL を使用したこの代替の接続方法は、現在サポートされていません。

を使用 ClientCertificates して、SSL 接続を確立するために使用するクライアント証明書を指定できます。 ServerCertificateValidationCallbackでは、SMTP サーバーによって提供される証明書を拒否できます。 SecurityProtocolプロパティを使用すると、使用する SSL プロトコルのバージョンを指定できます。

注意

プロパティが EnableSsltrue設定されていて、SMTP メール サーバーが EHLO コマンドへの応答で STARTTLS をアドバタイズしない場合、 メソッドまたは SendAsync メソッドのSend呼び出しによって がSmtpExceptionスローされます。

適用対象

こちらもご覧ください