ClientCredentials.ServiceCertificate Proprietà

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

Valore della proprietà

Oggetto X509CertificateRecipientClientCredential che rappresenta il certificato da utilizzare per un determinato servizio.

Esempio

Questo codice illustra come usare questa proprietà per ottenere il certificato del servizio e impostarne le proprietà.

X509CertificateRecipientClientCredential rcc =
    client.ClientCredentials.ServiceCertificate;

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

Commenti

È possibile utilizzare l'oggetto restituito da questa proprietà per configurare le proprietà del certificato chiamando i relativi membri.

È possibile specificare un singolo certificato predefinito e un certificato diverso da usare per la comunicazione con un particolare URI.

Tramite questa classe, è anche possibile controllare le impostazioni di autenticazione per i certificati del servizio negoziati tramite la negoziazione SSL/TLS eseguita a livello di messaggio.

Questa proprietà non deve sempre essere specificata. Il fatto che sia necessario dipende dalla modalità di autenticazione e dalle opzioni di negoziazione impostate sull'associazione usata per comunicare con il servizio. Alcune classi rilevanti che controllano questo comportamento sono MessageSecurityOverHttp e MessageSecurityOverTcp.

È anche possibile impostare questo valore usando l'elemento <certificato> in un file di configurazione dell'applicazione client.