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(); 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 X509CertificateCollectionEigenschaftswert
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.
