HttpWebClientProtocol.ClientCertificates Propriedade

Referência

Definição

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém a coleção de certificados do cliente.

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

Valor da propriedade

X509CertificateCollection

Um X509CertificateCollection que representa os certificados do cliente.

Atributos: BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra como carregar um certificado de cliente de um arquivo e, em seguida, adicioná-lo à ClientCertificates propriedade para chamar um método de serviço Web XML que usa certificados de cliente para autenticação.

// 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)

Comentários

Essa propriedade permite que um cliente passe um ou mais certificados de cliente, também conhecidos como certificados Authenticode X.509 v.3, ao chamar um método de serviço Web XML. Se o método de serviço Web XML tiver sido configurado para usar certificados de cliente, um certificado do cliente poderá ser usado como um mecanismo para autenticar um cliente. Para obter detalhes sobre como configurar certificados de cliente, consulte a documentação do Serviços de Informações da Internet (IIS).

Aplica-se a