HttpWebRequest.ClientCertificates Property

Definition

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(); 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, set
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public Property ClientCertificates As X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

Property Value

X509CertificateCollection

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.

Remarks

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.

Note

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 le premier élément de ClientCertificates (le cas échéant), ou tente de réutiliser des sessions anonymes si ClientCertificates 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.

Note

Pour des raisons de performances, vous ne devez pas ajouter un certificat client à un HttpWebRequest, sauf si vous savez que le serveur vous en 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, consultez la classe X509Certificate2Collection.For a code example illustrating how to enumerate the certificates in the client certificate store, see the X509Certificate2Collection class.

Applies to