HttpWebRequest.ClientCertificates 属性

定义

命名空间:

System.Net

程序集:

netstandard.dll, System.Net.Requests.dll

Source:

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指定的值为 。

注解

Caution

WebRequest、 HttpWebRequest、 ServicePoint和 WebClient 已过时，不应将其用于新开发。 改用 HttpClient。

应用程序可以将证书添加到集合，但可能无权访问它。 若要使用集合中包含的证书，应用程序必须具有与颁发证书的实体相同的访问权限。

注释

框架在创建 SSL 会话时缓存 SSL 会话，并尝试尽可能为新请求重复使用缓存会话。 尝试重复使用 SSL 会话时，框架使用第一个元素 ClientCertificates （如果有），或者尝试重复使用匿名会话（如果 ClientCertificates 为空）。

注释

出于性能原因，不应将客户端证书添加到客户端证书， HttpWebRequest 除非你知道服务器会请求它。

有关演示如何枚举客户端证书存储中的证书的代码示例，请参阅该 X509Certificate2Collection 类。