HttpWebRequest.ClientCertificates プロパティ

定義

名前空間:

System.Net

アセンブリ:

System.Net.Requests.dll

ソース:

HttpWebRequest.cs

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

public:
 property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); void set(System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ value); };

public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }

member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, set

Public Property ClientCertificates As X509CertificateCollection

プロパティ値

X509CertificateCollection

この要求に関連付けられているセキュリティ証明書を含む X509CertificateCollection。

例外

ArgumentNullException

設定操作に指定された値は nullです。

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

手記

フレームワークは、作成された SSL セッションをキャッシュし、可能であれば、キャッシュされたセッションを新しい要求に再利用しようとします。 SSL セッションを再利用しようとすると、フレームワークは ClientCertificates の最初の要素 (存在する場合) を使用するか、ClientCertificates が空の場合は匿名セッションを再利用しようとします。

手記

パフォーマンス上の理由から、サーバーが要求することがわかっている場合を除き、HttpWebRequest にクライアント証明書を追加しないでください。

クライアント証明書ストア内の証明書を列挙する方法を示すコード例については、X509Certificate2Collection クラスを参照してください。