HttpWebClientProtocol.ClientCertificates HttpWebClientProtocol.ClientCertificates HttpWebClientProtocol.ClientCertificates HttpWebClientProtocol.ClientCertificates Property

定義

クライアント証明書のコレクションを取得します。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; }
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

プロパティ値

次のコード例では、ファイルからクライアント証明書を読み込み、それをClientCertificatesプロパティに追加して、認証にクライアント証明書を使用する XML Web サービスメソッドを呼び出す方法を示します。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 サービスメソッドを呼び出すときに、Authenticode x.509 証明書とも呼ばれる1つ以上のクライアント証明書を渡すことができます。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 サービスメソッドが構成されている場合、クライアント証明書はクライアントを認証するための1つのメカニズムとして使用できます。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) のドキュメントを参照してください。For details on setting up client certificates, see the Internet Information Services (IIS) documentation.

適用対象

こちらもご覧ください