HttpWebRequest.ClientCertificates Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtient ou définit la collection de certificats de sécurité qui sont 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

X509CertificateCollection contenant les certificats de sécurité associés à cette requête.

Exceptions

ArgumentNullException

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

Remarques

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 avoir les mêmes droits d’accès que l’entité qui a émis le certificat.

Notes

Le Framework met en cache les sessions SSL au fur et à mesure qu’elles sont créées et tentent de réutiliser une session mise en cache pour une nouvelle requête, si possible. Lors de la tentative de réutilisation d’une session SSL, l’infrastructure utilise le premier élément de ClientCertificates (s’il en existe un) ou tente de réutiliser une session anonyme si ClientCertificates elle est vide.

Notes

Pour des raisons de performances, vous ne devez pas ajouter un 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 X509Certificate2Collection classe.