ClientCredentials.ServiceCertificate Eigenschaft

Definition

Ruft ein Objekt ab, das zum Angeben des X.509-Zertifikats eines Diensts verwendet wird.

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

Eigenschaftswert

Ein X509CertificateRecipientClientCredential Zertifikat, das für einen bestimmten Dienst verwendet werden soll.

Beispiele

Dieser Code zeigt, wie Sie diese Eigenschaft verwenden, um das Zertifikat des Diensts abzurufen und seine Eigenschaften festzulegen.

X509CertificateRecipientClientCredential rcc =
    client.ClientCredentials.ServiceCertificate;

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

Hinweise

Sie können das von dieser Eigenschaft zurückgegebene Objekt verwenden, um die Eigenschaften des Zertifikats zu konfigurieren, indem Sie dessen Member aufrufen.

Sie können ein einzelnes Standardzertifikat sowie ein anderes Zertifikat angeben, das bei der Kommunikation mit einem bestimmten URI verwendet werden soll.

Über diese Klasse steuern Sie auch die Authentifizierungseinstellungen für Dienstzertifikate, die über SSL/TLS-Aushandlung ausgehandelt wurden, die auf Nachrichtenebene ausgeführt werden.

Diese Eigenschaft muss nicht immer angegeben werden. Ob sie erforderlich ist, hängt vom Authentifizierungsmodus und den Aushandlungsoptionen ab, die für die Kommunikation mit dem Dienst verwendet werden. Einige relevante Klassen, die dieses Verhalten steuern, sind MessageSecurityOverHttp und MessageSecurityOverTcp.

Sie können diesen Wert auch mithilfe des <Zertifikatelements> in einer Clientanwendungskonfigurationsdatei festlegen.

Gilt für: