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
X509CertificateCollection que contiene los certificados de seguridad asociados a esta solicitud.
Excepciones
El valor especificado para una operación Set es null.
Comentarios
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 intenta 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 uno) 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 a HttpWebRequest 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 X509Certificate2Collection clase .