ClientCredentials.ServiceCertificate Właściwość

Definicja

Przestrzeń nazw:

System.ServiceModel.Description

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v8.0.0

Źródło:

ClientCredentials.cs

Pobiera obiekt używany do określania certyfikatu X.509 usługi.

public:
 property System::ServiceModel::Security::X509CertificateRecipientClientCredential ^ ServiceCertificate { System::ServiceModel::Security::X509CertificateRecipientClientCredential ^ get(); };

public System.ServiceModel.Security.X509CertificateRecipientClientCredential ServiceCertificate { get; }

member this.ServiceCertificate : System.ServiceModel.Security.X509CertificateRecipientClientCredential

Public ReadOnly Property ServiceCertificate As X509CertificateRecipientClientCredential

Wartość właściwości

X509CertificateRecipientClientCredential

Element X509CertificateRecipientClientCredential reprezentujący certyfikat do użycia dla określonej usługi.

Przykłady

Ten kod pokazuje, jak za pomocą tej właściwości pobrać certyfikat usługi i ustawić jej właściwości.

X509CertificateRecipientClientCredential rcc =
    client.ClientCredentials.ServiceCertificate;

X509Certificate2 cert = new X509Certificate2();
rcc.ScopedCertificates.Add(new Uri("http://fabrikam.com/sts"), cert);

Uwagi

Obiekt zwrócony przez tę właściwość umożliwia skonfigurowanie właściwości certyfikatu przez wywołanie jego elementów członkowskich.

Podczas komunikowania się z określonym identyfikatorem URI można określić pojedynczy certyfikat domyślny, a także inny certyfikat do użycia.

W ramach tej klasy można również kontrolować ustawienia uwierzytelniania certyfikatów usługi wynegocjowanych za pośrednictwem negocjacji SSL/TLS wykonywanych na poziomie komunikatu.

Ta właściwość nie zawsze musi być określona. To, czy jest wymagane, zależy od trybu uwierzytelniania i opcji negocjacji ustawionych na powiązanie używane do komunikowania się z usługą. Niektóre istotne klasy, które kontrolują to zachowanie, to MessageSecurityOverHttp i MessageSecurityOverTcp.

Tę wartość można również ustawić przy użyciu elementu certyfikatu<> w pliku konfiguracji aplikacji klienckiej.