ClientCredentials.ServiceCertificate Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Ottiene un oggetto utilizzato per specificare il certificato X.509 di un servizio.

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à

X509CertificateRecipientClientCredential

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

Esempio

Nel codice seguente viene illustrato come utilizzare 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 chiamandone i membri.

È possibile specificare un solo certificato predefinito oltre che un certificato diverso da utilizzare durante la comunicazione con un particolare URI.

Tramite questa classe si controllano, inoltre, le impostazioni di autenticazione per i certificati del servizio ottenuti tramite negoziazione SSL/TLS eseguita a livello di messaggio.

Questa proprietà non deve essere sempre specificata. Può essere necessaria a seconda della modalità di autenticazione e delle opzioni di negoziazione impostate sull'associazione utilizzata per comunicare con il servizio. MessageSecurityOverHttp e MessageSecurityOverTcp sono classi attinenti che controllano questo comportamento.

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