Condividi tramite


X509CertificateRecipientClientCredential.SetScopedCertificate Metodo

Definizione

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

Overload

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Imposta un certificato dal nome del soggetto, percorso dell'archivio certificati e nome dell'archivio certificati e lo memorizza in una raccolta indicizzata per essere utilizzato per l'URL che imposta l'ambito.

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

Imposta un certificato dal percorso dell'archivio certificati, nome dell'archivio certificati, tipo di ricerca X.509 e valore da cercare e lo memorizza in una raccolta indicizzata per essere utilizzato per l'URL che imposta l'ambito.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Imposta un certificato dal nome del soggetto, percorso dell'archivio certificati e nome dell'archivio certificati e lo memorizza in una raccolta indicizzata per essere utilizzato 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

Il nome completo del soggetto.

storeLocation
StoreLocation

Percorso dell'archivio certificati utilizzato 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

subjectName o targetService è null.

È stata tentata l'impostazione di una 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 del parametro storeLocation sono compresi 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 in un account del sistema, il certificato è in genere in LocalMachine. Se l'applicazione è in esecuzione in un account utente, il certificato è in genere in CurrentUser.

I valori del parametro storeName sono compresi nell'enumerazione StoreName.

Si applica a

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

Imposta un certificato dal percorso dell'archivio certificati, nome dell'archivio certificati, tipo di ricerca X.509 e valore da cercare e lo memorizza in una raccolta indicizzata per essere utilizzato 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 utilizzato dal servizio per ottenere il certificato del servizio.

storeName
StoreName

Nome dell'archivio certificati X.509 da aprire.

findType
X509FindType

Il 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

findValue o targetService è null.

È stata tentata l'impostazione di una 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 del parametro storeLocation sono compresi 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 in un account del sistema, il certificato è in genere in LocalMachine. Se l'applicazione è in esecuzione in un account utente, il certificato è in genere in CurrentUser.

I valori del parametro storeName sono compresi nell'enumerazione StoreName.

I valori del parametro findType sono compresi nell'enumerazione X509FindType.

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

Si applica a