Partager via


HttpWebRequest.ClientCertificates Propriété

Définition

Obtient ou définit la collection de certificats de sécurité associés à cette requête.

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

Valeur de propriété

X509CertificateCollection qui contient les certificats de sécurité associés à cette demande.

Exceptions

La valeur spécifiée pour une opération set est null.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Une application peut ajouter un certificat à une collection, mais elle n’a peut-être pas de droits d’accès. Pour utiliser un certificat contenu dans la collection, l’application doit disposer des mêmes droits d’accès que l’entité qui a émis le certificat.

Note

Framework met en cache les sessions SSL au fur et à mesure qu’elles sont créées et tente de réutiliser une session mise en cache pour une nouvelle requête, si possible. Lorsque vous tentez de réutiliser une session SSL, l’infrastructure utilise le premier élément de ClientCertificates (le cas échéant) ou tente de réutiliser une session anonyme si ClientCertificates est vide.

Note

Pour des raisons de performances, vous ne devez pas ajouter de certificat client à un HttpWebRequest, sauf si vous savez que le serveur le demande.

Pour obtenir un exemple de code illustrant comment énumérer les certificats dans le magasin de certificats client, consultez la classe X509Certificate2Collection.

S’applique à