X509CertificateRecipientClientCredential.SetDefaultCertificate Metodo
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.
SetDefaultCertificate(String, StoreLocation, StoreName) |
Specifica il certificato predefinito da utilizzare per il servizio. Per le associazioni che utilizzano sistemi di sicurezza dei messaggi basati sui certificati, questo certificato viene utilizzato per crittografare i messaggi inviati al servizio ed è previsto che venga utilizzato 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 utilizzano sistemi di sicurezza dei messaggi basati sui certificati, questo certificato viene utilizzato per crittografare i messaggi inviati al servizio ed è previsto che venga utilizzato dal servizio per firmare le risposte al client. |
Questi metodi ottengono un certificato dall'archivio che si trova nel percorso che corrisponde ai parametri specificati.
Per le associazioni che utilizzano sistemi di sicurezza dei messaggi basati sui certificati, questo certificato viene utilizzato per crittografare i messaggi inviati al servizio ed è previsto che venga utilizzato dal servizio per firmare le risposte al client.
Specifica il certificato predefinito da utilizzare per il servizio. Per le associazioni che utilizzano sistemi di sicurezza dei messaggi basati sui certificati, questo certificato viene utilizzato per crittografare i messaggi inviati al servizio ed è previsto che venga utilizzato 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 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.
Eccezioni
subjectName
è null
.
È stata tentata l'impostazione di una credenziale di sola lettura.
Esempio
Nell'esempio di codice seguente viene utilizzato questo metodo per specificare il certificato X.509 da utilizzare.
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 che si trova nel percorso che corrisponde al parametro subjectName
.
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
.NET 8 (package-provided) e altre versioni
Prodotto | Versioni |
---|---|
.NET | Core 1.0, Core 1.1, 8 (package-provided) |
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Specifica il certificato predefinito da utilizzare per il servizio. Per le associazioni che utilizzano sistemi di sicurezza dei messaggi basati sui certificati, questo certificato viene utilizzato per crittografare i messaggi inviati al servizio ed è previsto che venga utilizzato dal servizio per firmare le risposte al client.
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 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.
Eccezioni
findValue
è null
.
È stata tentata l'impostazione di una credenziale di sola lettura.
Esempio
Nell'esempio di codice seguente viene utilizzato questo metodo per specificare il certificato X.509 da utilizzare.
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 che si trova nel percorso che corrisponde ai parametri findType
e findValue
.
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
.NET 8 (package-provided) e altre versioni
Prodotto | Versioni |
---|---|
.NET | Core 1.0, Core 1.1, 8 (package-provided) |
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: