HttpWebClientProtocol.ClientCertificates 属性

定义

获取客户证书集合。Gets the collection of client certificates.

public:
 property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

属性值

X509CertificateCollection

X509CertificateCollection,它表示客户证书。An X509CertificateCollection that represents the client certificates.

属性

示例

下面的代码示例演示如何从文件加载客户端证书,然后将其添加到 ClientCertificates 属性,以便调用使用客户端证书进行身份验证的 XML Web service 方法。The following code example demonstrates how to load in a client certificate from a file and then add it to the ClientCertificates property for calling an XML Web service method that uses client certificates for authentication.

// Create a new instance of a proxy class for the Bank XML Web service.
BankSession bank = new BankSession();

// Load the client certificate from a file.
X509Certificate x509 = X509Certificate.CreateFromCertFile(@"c:\user.cer");

// Add the client certificate to the ClientCertificates property of the proxy class.
bank.ClientCertificates.Add(x509);

// Communicate with the Deposit XML Web service method,
// which requires authentication using client certificates.
bank.Deposit(500);
' Create a new instance of a proxy class for the Bank XML Web service.
Dim bank As BankSession = new BankSession()

' Load the client certificate from a file.
Dim x509 As X509Certificate = X509Certificate.CreateFromCertFile("c:\user.cer")

' Add the client certificate to the ClientCertificates property of the proxy class.
bank.ClientCertificates.Add(x509)

' Communicate with the Deposit XML Web service method,
' which requires authentication using client certificates.
bank.Deposit(500)

注解

调用 XML Web service 方法时,此属性允许客户端传递一个或多个客户端证书(也称为 Authenticode x.509)证书。This property allows a client to pass one or more client certificates, also known as Authenticode X.509 v.3 certificates, when calling an XML Web service method. 如果 XML Web service 方法已配置为使用客户端证书,则可以将客户端证书用作一种对客户端进行身份验证的机制。If the XML Web service method has been configured to use client certificates, a client certificate can be used as one mechanism for authenticating a client. 有关设置客户端证书的详细信息,请参阅 IIS) 文档 (的 Internet Information Services。For details on setting up client certificates, see the Internet Information Services (IIS) documentation.

适用于

另请参阅