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 Sammlung 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.X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionEigenschaftswert
Ein X509CertificateCollection Wert, der die Clientzertifikate darstellt.
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie in einem Clientzertifikat aus einer Datei geladen und anschließend der Eigenschaft zum Aufrufen einer XML-Webdienstmethode hinzugefügt wird, die Clientzertifikate für die ClientCertificates 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
Mit dieser Eigenschaft kann ein Client ein oder mehrere Clientzertifikate übergeben, die auch als Authenticode X.509 v.3-Zertifikate bezeichnet werden, wenn eine XML-Webdienstmethode aufgerufen wird. 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 (Internet Information Services, IIS).
