HttpWebRequest.ClientCertificates Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setmember this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollectionPublic Property ClientCertificates As X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionValeur 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.
