HttpWebRequest.ClientCertificates 属性
获取或设置与此请求关联的安全证书集合。
**命名空间:**System.Net
**程序集:**System（在 system.dll 中）
语法
声明
Public Property ClientCertificates As X509CertificateCollection
用法
Dim instance As HttpWebRequest
Dim value As X509CertificateCollection
value = instance.ClientCertificates
instance.ClientCertificates = value
public X509CertificateCollection ClientCertificates { get; set; }
public:
property X509CertificateCollection^ ClientCertificates {
X509CertificateCollection^ get ();
void set (X509CertificateCollection^ value);
}
/** @property */
public X509CertificateCollection get_ClientCertificates ()
/** @property */
public void set_ClientCertificates (X509CertificateCollection value)
public function get ClientCertificates () : X509CertificateCollection
public function set ClientCertificates (value : X509CertificateCollection)
属性值
X509CertificateCollection，包含与此请求关联的安全证书。
异常
| 异常类型 | 条件 |
|---|---|
为 Set 操作指定的值为 空引用（在 Visual Basic 中为 Nothing）。 |
备注
应用程序可向集合添加证书，但是可能没有对该证书的访问权限。若要使用包含在该集合中的证书，应用程序必须与颁发该证书的实体有着相同的访问权限。
提示
Framework 在创建 SSL 会话时缓存这些会话，如果可能，还尝试对新请求重用缓存的会话。试图重用 SSL 会话时，该框架将使用 ClientCertificates 的第一个元素（如果有）；如果 ClientCertificates 为空，则将尝试重用匿名会话。
提示
由于性能的原因，不应向 HttpWebRequest 添加客户端证书，除非知道服务器将要求提供该证书。
有关演示如何枚举客户端证书存储区中的证书的代码示例，请参见 X509Certificate2Collection 类。
Windows 95、Windows 98、Windows 98 Second Edition、Windows Millennium Edition 平台说明： 仅当不需要客户端证书时，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