HttpWebClientProtocol.ClientCertificates-Eigenschaft

Ruft die Auflistung von Clientzertifikaten ab.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public ReadOnly Property ClientCertificates As X509CertificateCollection
'Usage
Dim instance As HttpWebClientProtocol
Dim value As X509CertificateCollection

value = instance.ClientCertificates

public X509CertificateCollection ClientCertificates { get; }

public:
property X509CertificateCollection^ ClientCertificates {
    X509CertificateCollection^ get ();
}

/** @property */
public X509CertificateCollection get_ClientCertificates ()

public function get ClientCertificates () : X509CertificateCollection

Eigenschaftenwert

Eine X509CertificateCollection zur Darstellung der Clientzertifikate.

Hinweise

Diese Eigenschaft ermöglicht einem Client beim Aufrufen einer XML-Webdienstmethode das Übergeben mehrerer Clientzertifikate, die auch als Authenticode X.509v3-Zertifikate bezeichnet werden. Wenn die Verwendung von Clientzertifikaten in der XML-Webdienstmethode konfiguriert wurde, kann die Authentifizierung eines Clients u. a. mithilfe eines Clientzertifikats vorgenommen werden. Detaillierte Informationen über das Einrichten von Clientzertifikaten finden Sie in der IIS-Dokumentation (Internet Information Services).

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie ein Clientzertifikat aus einer Datei geladen und dann der ClientCertificates-Eigenschaft hinzugefügt wird, um eine XML-Webdienstmethode aufzurufen, bei der Clientzertifikate für die Authentifizierung verwendet werden.

' Create a new instance of a proxy class for the Bank XML Web service.
Dim bank As BankSession = new BankSession()

' Load the client certificate from a file.
Dim x509 As X509Certificate = X509Certificate.CreateFromCertFile("c:\user.cer")

' Add the client certificate to the ClientCertificates property of the proxy class.
bank.ClientCertificates.Add(x509)

' Communicate with the Deposit XML Web service method,
' which requires authentication using client certificates.
bank.Deposit(500)

// Create a new instance of a proxy class for the Bank XML Web service.
BankSession bank = new BankSession();

// Load the client certificate from a file.
X509Certificate x509 = X509Certificate.CreateFromCertFile(@"c:\user.cer");

// Add the client certificate to the ClientCertificates property of the proxy class.
bank.ClientCertificates.Add(x509);

// Communicate with the Deposit XML Web service method,
// which requires authentication using client certificates.
bank.Deposit(500);

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

HttpWebClientProtocol-Klasse
HttpWebClientProtocol-Member
System.Web.Services.Protocols-Namespace
X509CertificateCollection

Weitere Ressourcen

Sichern von mit ASP.NET erstellten XML-Webdiensten