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(); };public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); void set(System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ value); };public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollectionmember this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, setPublic ReadOnly Property ClientCertificates As X509CertificateCollectionPublic Property ClientCertificates As X509CertificateCollectionValore della proprietà
Oggetto X509CertificateCollection contenente i certificati di sicurezza associati a questa richiesta.
Eccezioni
Il valore specificato per un'operazione set è null.
Commenti
Caution
WebRequest
HttpWebRequest, ServicePoint, e WebClient sono obsoleti e non è consigliabile usarli per il nuovo sviluppo. Utilizzare 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.
Note
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, il framework usa il primo elemento di ClientCertificates (se presente) o tenta di riutilizzare una sessione anonima se ClientCertificates è vuoto.
Note
Per motivi di prestazioni, non è consigliabile aggiungere un certificato client a un a HttpWebRequest meno che non si sappia che il server lo richiederà.
Per un esempio di codice che illustra come enumerare i certificati nell'archivio certificati client, vedere la X509Certificate2Collection classe .