HttpWebClientProtocol.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.
Ruft die Auflistung von Clientzertifikaten ab.
public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection
Eigenschaftswert
Eine X509CertificateCollection zur Darstellung der Clientzertifikate.
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie ein Clientzertifikat aus einer Datei laden und es dann der ClientCertificates -Eigenschaft zum Aufrufen einer XML-Webdienstmethode hinzufügen, die Clientzertifikate für die Authentifizierung verwendet.
// 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);
' 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)
Hinweise
Diese Eigenschaft ermöglicht es einem Client, beim Aufrufen einer XML-Webdienstmethode ein oder mehrere Clientzertifikate( auch bekannt als Authenticode X.509 v.3-Zertifikate) zu übergeben. Wenn die XML-Webdienstmethode für die Verwendung von Clientzertifikaten konfiguriert wurde, kann ein Clientzertifikat als ein Mechanismus für die Authentifizierung eines Clients verwendet werden. Ausführliche Informationen zum Einrichten von Clientzertifikaten finden Sie in der Dokumentation zu Internetinformationsdienste (IIS).