HttpWebRequest.ClientCertificates Proprietà

Definizione

Ottiene o imposta la raccolta dei certificati di sicurezza associati alla 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, set
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public Property ClientCertificates As X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

Valore della proprietà

X509CertificateCollection

Classe X509CertificateCollection contenente i certificati di sicurezza associati a questa richiesta.

Eccezioni

Il valore specificato per un'operazione set è null.

Commenti

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 rilasciato 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 non si sappia che il server lo chiederà.

Per un esempio di codice che illustra come enumerare i certificati nell'archivio certificati client, vedere la X509Certificate2Collection classe .

Si applica a