HttpWebRequest.ClientCertificates Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

HttpWebRequest.cs

Obtém ou define a coleção de certificados de segurança que estão associadas essa solicitação.

public:
 property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); void set(System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ value); };

public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }

member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, set

Public Property ClientCertificates As X509CertificateCollection

Valor da propriedade

X509CertificateCollection

Um X509CertificateCollection que contém os certificados de segurança associados a essa solicitação.

Exceções

ArgumentNullException

O valor especificado para uma operação de definição é null.

Comentários

Um aplicativo pode adicionar um certificado a uma coleção, mas pode não ter direitos de acesso a ele. Para usar um certificado contido na coleção, o aplicativo deve ter os mesmos direitos de acesso que a entidade que emitiu o certificado.

Observação

A Estrutura armazena em cache sessões SSL conforme elas são criadas e tenta reutilizar uma sessão armazenada em cache para uma nova solicitação, se possível. Ao tentar reutilizar uma sessão SSL, o Framework usa o primeiro elemento de ClientCertificates (se houver um) ou tenta reutilizar uma sessão anônima se ClientCertificates estiver vazio.

Observação

Por motivos de desempenho, você não deve adicionar um certificado de cliente a um HttpWebRequest , a menos que saiba que o servidor o solicitará.

Para obter um exemplo de código que ilustra como enumerar os certificados no repositório de certificados do cliente, consulte a X509Certificate2Collection classe .