HttpWebRequest.ClientCertificates プロパティ

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

HttpWebRequest.ClientCertificates プロパティ

この要求に関連付けられているセキュリティ証明書のコレクションを取得または設定します。

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

Visual Basic (宣言)

Public Property ClientCertificates As
 X509CertificateCollection

Visual Basic (使用法)

Dim instance As HttpWebRequest
Dim value As X509CertificateCollection

value = instance.ClientCertificates

instance.ClientCertificates = value

C#

public X509CertificateCollection ClientCertificates { get;
 set; }

C++

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

J#

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

/** @property */
public void set_ClientCertificates (X509CertificateCollection
 value)

JScript

public function get ClientCertificates
 () : X509CertificateCollection

public function set ClientCertificates
 (value : X509CertificateCollection)

プロパティ値
この要求に関連付けられているセキュリティ証明書を格納している X509CertificateCollection。

例外

例外の種類	条件
ArgumentNullException	設定操作に指定された値が null 参照 (Visual Basic では Nothing) です。

解説

アプリケーションはコレクションに証明書を追加できますが、そのためのアクセス権を持っていない可能性があります。コレクションに格納された証明書を使用するには、アプリケーションは、その証明書を発行したエンティティと同じアクセス権を持つ必要があります。

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

メモ
パフォーマンスを維持するために、サーバーからクライアント証明書が要求されることがわかっている場合を除いて、HttpWebRequest にクライアント証明書を追加しないでください。 クライアント証明書ストアの証明書を列挙する方法を示したコード例については、X509Certificate2Collection クラスのトピックを参照してください。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0

参照

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