HttpWebRequest.ClientCertificates Eigenschaft

Definition

Ruft die dieser Anforderung zugeordnete Auflistung von Sicherheitszertifikaten ab oder legt diese fest.Gets or sets the collection of security certificates that are associated with this request.

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 mit den dieser Anforderung zugeordneten Sicherheitszertifikaten.The X509CertificateCollection that contains the security certificates associated with this request.

Ausnahmen

Der für einen SET-Vorgang festgelegte Wert ist null.The value specified for a set operation is null.

Hinweise

Eine Anwendung kann einer Sammlung ein Zertifikat hinzufügen, verfügt jedoch möglicherweise nicht über die entsprechenden Zugriffsrechte.An application can add a certificate to a collection, but might not have access rights to it. Um ein in der Auflistung enthaltenes Zertifikat verwenden zu können, muss die Anwendung über die gleichen Zugriffsrechte wie die Entität verfügen, die das Zertifikat ausgestellt hat.To use a certificate contained in the collection, the application must have the same access rights as the entity that issued the certificate.

Hinweis

Das Framework speichert SSL-Sitzungen bei der Erstellung zwischen und versucht nach Möglichkeit, eine zwischengespeicherte Sitzung für eine neue Anforderung wiederzuverwenden.The Framework caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. 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.When attempting to reuse an SSL session, the Framework uses the first element of ClientCertificates (if there is one), or tries to reuse an anonymous sessions if ClientCertificates is empty.

Hinweis

Aus Leistungsgründen sollten Sie ein Client Zertifikat nicht zu einem HttpWebRequest hinzufügen, es sei denn, Sie wissen, dass der Server Sie dazu auffordern wird.For performance reasons, you shouldn't add a client certificate to a HttpWebRequest unless you know the server will ask for it.

Ein Codebeispiel, das veranschaulicht, wie die Zertifikate im Zertifikat Speicher des Clients aufgelistet werden, finden Sie in der X509Certificate2Collection-Klasse.For a code example illustrating how to enumerate the certificates in the client certificate store, see the X509Certificate2Collection class.

Gilt für: