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

注解

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

注意

框架在创建 SSL 会话时缓存这些会话,并尝试为新请求重复使用缓存的会话(如果可能)。 尝试重用 SSL 会话时,如果存在一个) ,框架将使用 (的第一个元素 ClientCertificates ;如果 ClientCertificates 为空,则尝试重用匿名会话。

注意

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

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

适用于