HttpWebRequest.ClientCertificates Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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(); };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 X509CertificateCollectionEigenschaftswert
Enthält X509CertificateCollection die Sicherheitszertifikate, 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.
Note
Das Framework speichert SSL-Sitzungen während der Erstellung zwischen und versucht, eine zwischengespeicherte Sitzung für eine neue Anforderung ggf. wiederzuverwenden. Wenn Sie versuchen, eine SSL-Sitzung wiederzuverwenden, verwendet das Framework das erste Element von ClientCertificates (falls vorhanden) oder versucht, eine anonyme Sitzung wiederzuverwenden, wenn ClientCertificates sie leer ist.
Note
Aus Leistungsgründen sollten Sie einem Clientzertifikat kein Clientzertifikat HttpWebRequest 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.