HttpWebRequest.ClientCertificates Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la raccolta di certificati di sicurezza associati a questa richiesta.
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 X509CertificateCollectionValore della proprietà
Il X509CertificateCollection che contiene i certificati di sicurezza associati a questa richiesta.
Eccezioni
Il valore specificato per un'operazione set è null.
Commenti
Cautela
WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.
Un'applicazione può aggiungere un certificato a una raccolta, ma potrebbe non avere diritti di accesso. Per usare un certificato contenuto nella raccolta, l'applicazione deve avere gli stessi diritti di accesso dell'entità che ha emesso il certificato.
Nota
Framework memorizza nella cache le sessioni SSL durante la creazione e tenta di riutilizzare una sessione memorizzata nella cache per una nuova richiesta, se possibile. Quando si tenta di riutilizzare una sessione SSL, framework usa il primo elemento di ClientCertificates (se presente) o tenta di riutilizzare una sessione anonima se ClientCertificates è vuoto.
Nota
Per motivi di prestazioni, non è consigliabile aggiungere un certificato client a un HttpWebRequest a meno che il server non lo richieda.
Per un esempio di codice che illustra come enumerare i certificati nell'archivio certificati client, vedere la classe X509Certificate2Collection.
