Freigeben über


HttpWebRequest.ClientCertificates-Eigenschaft

Ruft die dieser Anforderung zugeordnete Auflistung von Sicherheitszertifikaten ab oder legt diese fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property ClientCertificates As X509CertificateCollection
'Usage
Dim instance As HttpWebRequest
Dim value As X509CertificateCollection

value = instance.ClientCertificates

instance.ClientCertificates = value
public X509CertificateCollection ClientCertificates { get; set; }
public:
property X509CertificateCollection^ ClientCertificates {
    X509CertificateCollection^ get ();
    void set (X509CertificateCollection^ value);
}
/** @property */
public X509CertificateCollection get_ClientCertificates ()

/** @property */
public void set_ClientCertificates (X509CertificateCollection value)
public function get ClientCertificates () : X509CertificateCollection

public function set ClientCertificates (value : X509CertificateCollection)

Eigenschaftenwert

Die X509CertificateCollection mit den dieser Anforderung zugeordneten Sicherheitszertifikaten.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

Der für einen set-Vorgang angegebene Wert ist NULL (Nothing in Visual Basic).

Hinweise

Eine Anwendung kann einer Auflistung ein Zertifikat hinzufügen, verfügt jedoch möglicherweise nicht über Zugriffsrechte für die Auflistung. Um ein Zertifikat in der Auflistung zu verwenden, muss die Anwendung über dieselben Zugriffsrechte wie die Entität verfügen, die das Zertifikat ausgegeben hat.

Hinweis

Das Framework zwischenspeichert SSL-Sitzungen bei ihrer Erstellung und versucht, zwischengespeicherte Sitzungen für neue Anforderungen wiederzuverwenden, sofern möglich. Für die erneute Verwendung einer SSL-Sitzung verwendet das Framework das erste Element von ClientCertificates (sofern vorhanden) oder versucht, eine anonyme Sitzung erneut zu verwenden, falls ClientCertificates leer ist.

Hinweis

Aus Gründen der Leistung sollten Sie einem HttpWebRequest kein Clientzertifikat hinzufügen, sofern nicht bekannt ist, ob der Server dieses verlangt.

Ein Codebeispiel, indem die Enumeration des Clientzertifikatspeichers veranschaulicht wird, finden Sie unter der X509Certificate2Collection-Klasse.

Hinweis zu Windows 95, Windows 98, Windows 98 Zweite Ausgabe, Windows Millennium Edition: Das Framework versucht nur dann, eine SSL-Sitzung erneut zu verwenden, wenn kein Clientzertifikat erforderlich ist.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HttpWebRequest-Klasse
HttpWebRequest-Member
System.Net-Namespace