X509CertificateRecipientClientCredential.SetDefaultCertificate Metodo

Definizione

Spazio dei nomi:: System.ServiceModel.Security

Assembly:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Pacchetto:: System.ServiceModel.Primitives v10.0.652802

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica il certificato predefinito da utilizzare per il servizio.

Overload

Nome	Descrizione
SetDefaultCertificate(String, StoreLocation, StoreName)	Specifica il certificato predefinito da utilizzare per il servizio. Per le associazioni che usano la sicurezza dei messaggi basata su certificati, questo certificato viene usato per crittografare i messaggi al servizio e deve essere usato dal servizio per firmare le risposte al client.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Specifica il certificato predefinito da utilizzare per il servizio. Per le associazioni che usano la sicurezza dei messaggi basata su certificati, questo certificato viene usato per crittografare i messaggi al servizio e deve essere usato dal servizio per firmare le risposte al client.

Commenti

Questi metodi ottengono un certificato dall'archivio nel percorso specificato che corrisponde ai parametri specificati.

Per le associazioni che usano la sicurezza dei messaggi basata su certificati, questo certificato viene usato per crittografare i messaggi al servizio e deve essere usato dal servizio per firmare le risposte al client.

SetDefaultCertificate(String, StoreLocation, StoreName)

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

Specifica il certificato predefinito da utilizzare per il servizio. Per le associazioni che usano la sicurezza dei messaggi basata su certificati, questo certificato viene usato per crittografare i messaggi al servizio e deve essere usato dal servizio per firmare le risposte al client.

public:
 void SetDefaultCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);

public void SetDefaultCertificate(string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);

member this.SetDefaultCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit

Public Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

Parametri

subjectName: String

Nome distinto dell'oggetto.

storeLocation: StoreLocation

Percorso dell'archivio certificati usato dal servizio per ottenere il certificato del servizio.

storeName: StoreName

Nome dell'archivio certificati X.509 da aprire.

Eccezioni

ArgumentNullException

subjectName è null.

InvalidOperationException

Tentativo di impostazione quando la credenziale è di sola lettura.

Esempio

Il codice seguente usa questo metodo per specificare un certificato X.509 da usare.

public void snippet23(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate("http://fabrikam.com/sts",
                             StoreLocation.CurrentUser,
                             StoreName.TrustedPeople);
}

Commenti

Questo metodo ottiene un certificato dall'archivio nel percorso specificato che corrisponde al subjectName parametro .

I valori per storeLocation sono inclusi nell'enumerazione StoreLocation :

LocalMachine: l'archivio certificati assegnato al computer locale.
CurrentUser: archivio certificati usato dall'utente corrente (impostazione predefinita).

Se l'applicazione è in esecuzione con un account di sistema, il certificato è in genere in LocalMachine. Se l'applicazione è in esecuzione con un account utente, il certificato è in genere in CurrentUser.

I valori per storeName sono inclusi nell'enumerazione StoreName .

Si applica a

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

public:
 void SetDefaultCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);

public void SetDefaultCertificate(System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);

member this.SetDefaultCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit

Public Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

Parametri

storeLocation: StoreLocation

Percorso dell'archivio certificati usato dal servizio per ottenere il certificato del servizio.

storeName: StoreName

Nome dell'archivio certificati X.509 da aprire.

findType: X509FindType

Tipo di ricerca X.509 da eseguire.

findValue: Object

Valore da cercare nell'archivio certificati X.509.

Eccezioni

ArgumentNullException

findValue è null.

InvalidOperationException

Tentativo di impostazione quando la credenziale è di sola lettura.

Esempio

Il codice seguente usa questo metodo per specificare un certificato X.509 da usare.

public void snippet22(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS");
}

Commenti

Questo metodo ottiene un certificato dall'archivio nel percorso specificato che corrisponde ai findType parametri e findValue .

I valori per storeLocation sono inclusi nell'enumerazione StoreLocation :

LocalMachine: l'archivio certificati assegnato al computer locale.
CurrentUser: archivio certificati usato dall'utente corrente (impostazione predefinita).

I valori per storeName sono inclusi nell'enumerazione StoreName .

I valori per findType sono inclusi nell'enumerazione X509FindType .

L'enumerazione più comunemente usata è FindBySubjectName, che esegue una ricerca senza distinzione tra maiuscole e minuscole sul nome soggetto dei certificati nell'archivio specificato. Può trattarsi di una ricerca imprecisa. Se non vengono trovati certificati o più certificati che soddisfano i criteri, viene generata un'eccezione InvalidOperationException .

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?