Compartilhar via


HttpWebRequest.ClientCertificates Propriedade

Definição

Obtém ou define a coleção de certificados de segurança associados a 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:
 property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, set
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public Property ClientCertificates As X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

Valor da propriedade

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

Exceções

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

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

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.

Nota

O Framework armazena em cache sessões SSL à medida que 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 uma) ou tenta reutilizar uma sessão anônima se ClientCertificates estiver vazia.

Nota

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 classe X509Certificate2Collection.

Aplica-se a