HttpWebRequest.ClientCertificates Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a coleção de certificados de segurança associados a este pedido.
public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };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; }public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollectionmember this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, setPublic ReadOnly Property ClientCertificates As X509CertificateCollectionPublic Property ClientCertificates As X509CertificateCollectionValor de Propriedade
O X509CertificateCollection que contém os certificados de segurança associados a este pedido.
Exceções
O valor especificado para uma operação de conjunto é null.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
Uma aplicação pode adicionar um certificado a uma coleção, mas pode não ter direitos de acesso a ela. Para utilizar um certificado contido na coleção, o pedido deve ter os mesmos direitos de acesso que a entidade que emitiu o certificado.
Note
O Framework armazena em cache as sessões SSL à medida que são criadas e tenta reutilizar uma sessão em cache para um novo pedido, se possível. Ao tentar reutilizar uma sessão SSL, o Framework utiliza o primeiro elemento de ClientCertificates (se existir), ou tenta reutilizar uma sessão anónima se ClientCertificates estiver vazio.
Note
Por razões de desempenho, não deve adicionar um certificado de cliente a HttpWebRequest menos que saiba que o servidor o vai pedir.
Para um exemplo de código que ilustra como enumerar os certificados no armazenamento de certificados do cliente, veja a X509Certificate2Collection classe.