ClientCredentials.ServiceCertificate Propriété

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Obtient un objet servant à spécifier le certificat X.509 d'un service.

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

Valeur de propriété

X509CertificateRecipientClientCredential

X509CertificateRecipientClientCredential qui représente le certificat à utiliser pour un service particulier.

Exemples

Le code suivant montre comment utiliser cette propriété pour obtenir le certificat du service et définir ses propriétés.

X509CertificateRecipientClientCredential rcc =
    client.ClientCredentials.ServiceCertificate;

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

Remarques

Vous pouvez utiliser l'objet retourné par cette propriété pour configurer les propriétés du certificat en appelant ses membres.

Vous pouvez spécifier un certificat par défaut unique ainsi qu'un autre certificat à utiliser lors de la communication avec un URI particulier.

Grâce à cette classe, vous pouvez ainsi déterminer également les paramètres d'authentification pour les certificats de service négociés par SSL/TLS effectuée sur le message.

Cette propriété ne doit pas toujours être spécifiée. Son caractère obligatoire varie en fonction du mode d’authentification et des options de négociation définies sur la liaison utilisée pour communiquer avec le service. MessageSecurityOverHttp et MessageSecurityOverTcp constituent des classes pertinentes qui contrôlent ce comportement.

Vous pouvez également définir cette valeur à l’aide de l’élément <de certificat> dans un fichier de configuration d’application cliente.