HttpWebRequest.ClientCertificates Eigenschaft

Definition

Dient zum Abrufen oder Festlegen der Auflistung von Sicherheitszertifikaten, die dieser Anforderung zugeordnet sind.

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

Eigenschaftswert

Die X509CertificateCollection, die die Sicherheitszertifikate enthält, die dieser Anforderung zugeordnet sind.

Ausnahmen

Der für einen Set-Vorgang angegebene Wert ist null.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Eine Anwendung kann einer Sammlung ein Zertifikat hinzufügen, hat aber möglicherweise keine Zugriffsrechte dafür. Um ein in der Sammlung enthaltenes Zertifikat zu verwenden, muss die Anwendung über dieselben Zugriffsrechte wie die Entität verfügen, die das Zertifikat ausgestellt hat.

Anmerkung

Das Framework speichert SSL-Sitzungen während der Erstellung zwischen und versucht, eine zwischengespeicherte Sitzung für eine neue Anforderung ggf. wiederzuverwenden. Beim Versuch, eine SSL-Sitzung wiederzuverwenden, verwendet das Framework das erste Element von ClientCertificates (sofern vorhanden), oder versucht, anonyme Sitzungen wiederzuverwenden, wenn ClientCertificates leer ist.

Anmerkung

Aus Leistungsgründen sollten Sie einem HttpWebRequest kein Clientzertifikat hinzufügen, es sei denn, Sie wissen, dass der Server danach fragt.

Ein Codebeispiel zur Aufzählung der Zertifikate im Clientzertifikatspeicher finden Sie in der X509Certificate2Collection Klasse.

Gilt für: