HttpWebRequest.ClientCertificates Propriedade
Definição
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 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, setmember this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollectionPublic Property ClientCertificates As X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionValor 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.
