SmtpClient.ClientCertificates プロパティ

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

SmtpClient.ClientCertificates プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public ReadOnly Property
 ClientCertificates As X509CertificateCollection

Visual Basic (使用法)

Dim instance As SmtpClient
Dim value As X509CertificateCollection

value = instance.ClientCertificates

C#

public X509CertificateCollection ClientCertificates { get;
 }

C++

public:
property X509CertificateCollection^ ClientCertificates {
    X509CertificateCollection^ get ();
}

J#

/** @property */
public X509CertificateCollection get_ClientCertificates ()

JScript

public function get ClientCertificates
 () : X509CertificateCollection

プロパティ値
1 つ以上のクライアント証明書を保持している X509CertificateCollection。既定値は、構成ファイルのメール構成属性から派生します。

解説

既定では、クライアント証明書は省略できますが、サーバー構成には、初期接続のネゴシエーションの一部として有効な証明書がクライアントに存在する必要がある場合があります。

メモ
.NET Framework は、作成された SSL セッションをキャッシュし、可能な場合にはキャッシュされているセッションを新しい要求に再利用しようとします。SSL セッションの再利用を試みる場合、.NET Framework は、ClientCertificates が存在すればその最初の要素を使用し、ClientCertificates が空であれば匿名セッションの再利用を試みます。

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition プラットフォームメモ : .NET Framework は、クライアント証明書が必要でない場合にだけ SSL セッションの再利用を試みます。

使用例

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

C#

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 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.EnableSsl = true;
    client.Send(message);
}

プラットフォーム

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 名前空間
その他の技術情報
mailSettings 要素 (ネットワーク設定)