HttpWebRequest.ClientCertificates プロパティ

定義

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

public:
 property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); void set(System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ value); };
public:
 property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, set
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public Property ClientCertificates As X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

プロパティ値

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

例外

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

注釈

注意

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

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

手記

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

手記

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

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

適用対象