X509CertificateRecipientClientCredential.SetScopedCertificate 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.

Imposta un certificato da un archivio e lo archivia in una raccolta indicizzata dall'URL che imposta l'ambito.

Overload

Nome	Descrizione
SetScopedCertificate(String, StoreLocation, StoreName, Uri)	Imposta un certificato in base al nome soggetto, al percorso dell'archivio certificati e al nome dell'archivio certificati e lo archivia in una raccolta da usare per l'URL che imposta l'ambito.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)	Imposta un certificato in base al percorso dell'archivio certificati, al nome dell'archivio certificati, al tipo di ricerca X.509 e al valore da cercare e lo archivia in una raccolta da usare per l'URL che imposta l'ambito.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

Imposta un certificato in base al nome soggetto, al percorso dell'archivio certificati e al nome dell'archivio certificati e lo archivia in una raccolta da usare per l'URL che imposta l'ambito.

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

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

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

Public Sub SetScopedCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName, targetService As Uri)

Parametri

subjectName: String

Nome del soggetto completo.

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.

targetService: Uri

URL che imposta l'ambito.

Eccezioni

ArgumentNullException

subjectName o targetService è null.

InvalidOperationException

Tentativo di impostazione quando la credenziale è di sola lettura.

Esempio

Questo codice illustra come chiamare questo metodo.

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

Commenti

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

SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

Origine:: X509CertificateRecipientClientCredential.cs

Imposta un certificato in base al percorso dell'archivio certificati, al nome dell'archivio certificati, al tipo di ricerca X.509 e al valore da cercare e lo archivia in una raccolta da usare per l'URL che imposta l'ambito.

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

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

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

Public Sub SetScopedCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object, targetService As Uri)

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.

targetService: Uri

URL che imposta l'ambito.

Eccezioni

ArgumentNullException

findValue o targetService è null.

InvalidOperationException

Tentativo di impostazione quando la credenziale è di sola lettura.

Esempio

Questo codice illustra come chiamare questo metodo.

public void snippet20(CalculatorClient client)
{
    X509CertificateRecipientClientCredential rcc = client.ClientCredentials.ServiceCertificate;
    rcc.SetScopedCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS",
                             new Uri("http://fabrikam.com/sts"));
}

rcc.SetScopedCertificate(StoreLocation.CurrentUser, _
            StoreName.TrustedPeople, _
            X509FindType.FindBySubjectName, _
            "FabrikamSTS", _
            New Uri("http://fabrikam.com/sts"))

Commenti

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, verrà generata un'eccezione InvalidOperationException .

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?