ClientCredentials.ServiceCertificate Propriété

Définition

Obtient un objet servant à spécifier le certificat X.509 d'un service.Gets an object used to specify a service's X.509 certificate.

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 qui représente le certificat à utiliser pour un service particulier.An X509CertificateRecipientClientCredential that represents the certificate to use for a particular service.

Exemples

Le code suivant montre comment utiliser cette propriété pour obtenir le certificat du service et définir ses propriétés.This code shows how to use this property to get the service's certificate and set its properties.

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.You can use the object returned by this property to configure the certificate's properties by calling its members.

Vous pouvez spécifier un certificat par défaut unique ainsi qu'un autre certificat à utiliser lors de la communication avec un URI particulier.You can specify a single default certificate as well as a different certificate to be used when communicating with a particular URI.

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.Through this class, you also control the authentication settings for service certificates negotiated through SSL/TLS negotiation performed at the message level.

Cette propriété ne doit pas toujours être spécifiée.This property does not always have to be specified. 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.Whether it is required depends on the authentication mode and negotiation options set on the binding that is used to communicate with the service. MessageSecurityOverHttp et MessageSecurityOverTcp constituent des classes pertinentes qui contrôlent ce comportement.Some relevant classes that control this behavior are MessageSecurityOverHttp and MessageSecurityOverTcp.

Vous pouvez également définir cette valeur à l’aide de l’élément <certificat> dans un fichier de configuration d’application cliente.You can also set this value using the <certificate> element in a client application configuration file.

S’applique à