HttpWebRequest.ClientCertificates Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la colección de certificados de seguridad asociados a esta solicitud.
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 de propiedad
El X509CertificateCollection que contiene los certificados de seguridad asociados a esta solicitud.
Excepciones
El valor especificado para una operación set es null.
Comentarios
Cautela
WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.
Una aplicación puede agregar un certificado a una colección, pero es posible que no tenga derechos de acceso. Para usar un certificado contenido en la colección, la aplicación debe tener los mismos derechos de acceso que la entidad que emitió el certificado.
Nota
Framework almacena en caché las sesiones SSL a medida que se crean e intentan reutilizar una sesión almacenada en caché para una nueva solicitud, si es posible. Al intentar reutilizar una sesión SSL, framework usa el primer elemento de ClientCertificates (si hay alguno) o intenta reutilizar una sesión anónima si ClientCertificates está vacía.
Nota
Por motivos de rendimiento, no debe agregar un certificado de cliente a un HttpWebRequest a menos que sepa que el servidor lo solicitará.
Para obtener un ejemplo de código que ilustra cómo enumerar los certificados en el almacén de certificados de cliente, consulte la clase X509Certificate2Collection.
