HttpWebRequest.ClientCertificates HttpWebRequest.ClientCertificates HttpWebRequest.ClientCertificates HttpWebRequest.ClientCertificates Property

Définition

Obtient ou définit la collection de certificats de sécurité qui sont associés à cette requête.Gets or sets the collection of security certificates that are associated with this request.

public:
 property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

Valeur de propriété

X509CertificateCollection contenant les certificats de sécurité associés à cette requête.The X509CertificateCollection that contains the security certificates associated with this request.

Exceptions

La valeur spécifiée pour une opération set est null.The value specified for a set operation is null.

Remarques

Une application peut ajouter un certificat à une collection, mais peut ne pas avoir de droits d’accès à celle-ci.An application can add a certificate to a collection, but might not have access rights to it. Pour utiliser un certificat contenu dans la collection, l’application doit avoir les mêmes droits d’accès que l’entité qui a émis le certificat.To use a certificate contained in the collection, the application must have the same access rights as the entity that issued the certificate.

Notes

Le Framework met en cache les sessions SSL au fur et à mesure de leur création et tente de réutiliser une session mise en cache pour une nouvelle demande, si possible.The Framework caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. Lors de la tentative de réutilisation d’une session SSL, le Framework utilise ClientCertificates le premier élément de (le cas échéant) ou tente de réutiliser une ClientCertificates session anonyme si est vide.When attempting to reuse an SSL session, the Framework uses the first element of ClientCertificates (if there is one), or tries to reuse an anonymous sessions if ClientCertificates is empty.

Notes

Pour des raisons de performances, vous ne devez pas ajouter un HttpWebRequest certificat client à un, sauf si vous savez que le serveur le demande.For performance reasons, you shouldn't add a client certificate to a HttpWebRequest unless you know the server will ask for it.

Pour obtenir un exemple de code illustrant comment énumérer les certificats dans le magasin de certificats du client X509Certificate2Collection , consultez la classe.For a code example illustrating how to enumerate the certificates in the client certificate store, see the X509Certificate2Collection class.

S’applique à