X509CertificateRecipientClientCredential.SetDefaultCertificate Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll.
Überlädt
| Name | Beschreibung |
|---|---|
| SetDefaultCertificate(String, StoreLocation, StoreName) |
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Für Bindungen, die zertifikatbasierte Nachrichtensicherheit verwenden, wird dieses Zertifikat verwendet, um Nachrichten an den Dienst zu verschlüsseln und vom Dienst für das Signieren von Antworten auf den Client zu verwenden. |
| SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object) |
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Für Bindungen, die zertifikatbasierte Nachrichtensicherheit verwenden, wird dieses Zertifikat verwendet, um Nachrichten an den Dienst zu verschlüsseln und vom Dienst für das Signieren von Antworten auf den Client zu verwenden. |
Hinweise
Diese Methoden erhalten ein Zertifikat aus dem Speicher am angegebenen Speicherort, der den angegebenen Parametern entspricht.
Für Bindungen, die zertifikatbasierte Nachrichtensicherheit verwenden, wird dieses Zertifikat verwendet, um Nachrichten an den Dienst zu verschlüsseln und vom Dienst für das Signieren von Antworten auf den Client zu verwenden.
SetDefaultCertificate(String, StoreLocation, StoreName)
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Für Bindungen, die zertifikatbasierte Nachrichtensicherheit verwenden, wird dieses Zertifikat verwendet, um Nachrichten an den Dienst zu verschlüsseln und vom Dienst für das Signieren von Antworten auf den Client zu verwenden.
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 -> unitPublic Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)Parameter
- subjectName
- String
Der Name des Betreffs.
- storeLocation
- StoreLocation
Der Speicherort des Zertifikatspeichers, den der Dienst zum Abrufen des Dienstzertifikats verwendet.
- storeName
- StoreName
Der Name des zu öffnenden X.509-Zertifikatspeichers.
Ausnahmen
subjectName ist null.
Es wurde versucht, festzulegen, wann die Anmeldeinformationen schreibgeschützt sind.
Beispiele
Der folgende Code verwendet diese Methode, um ein zu verwendenes X.509-Zertifikat anzugeben.
public void snippet23(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate("http://fabrikam.com/sts",
StoreLocation.CurrentUser,
StoreName.TrustedPeople);
}
Hinweise
Diese Methode ruft ein Zertifikat aus dem Speicher am angegebenen Speicherort ab, der dem subjectName Parameter entspricht.
Werte für storeLocation die Enumeration sind enthalten StoreLocation :
LocalMachine: der dem lokalen Computer zugewiesene Zertifikatspeicher.
CurrentUser: der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).
Wenn die Anwendung unter einem Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Anwendung unter einem Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.
Die Werte für storeName diese sind in der StoreName Enumeration enthalten.
Gilt für:
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Für Bindungen, die zertifikatbasierte Nachrichtensicherheit verwenden, wird dieses Zertifikat verwendet, um Nachrichten an den Dienst zu verschlüsseln und vom Dienst für das Signieren von Antworten auf den Client zu verwenden.
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 -> unitPublic Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)Parameter
- storeLocation
- StoreLocation
Der Speicherort des Zertifikatspeichers, den der Dienst zum Abrufen des Dienstzertifikats verwendet.
- storeName
- StoreName
Der Name des zu öffnenden X.509-Zertifikatspeichers.
- findType
- X509FindType
Der Typ der X.509-Suche, die ausgeführt werden soll.
- findValue
- Object
Der Wert, nach dem im X.509-Zertifikatspeicher gesucht werden soll.
Ausnahmen
findValue ist null.
Es wurde versucht, festzulegen, wann die Anmeldeinformationen schreibgeschützt sind.
Beispiele
Der folgende Code verwendet diese Methode, um ein zu verwendenes X.509-Zertifikat anzugeben.
public void snippet22(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
StoreName.TrustedPeople,
X509FindType.FindBySubjectName,
"FabrikamSTS");
}
Hinweise
Diese Methode ruft ein Zertifikat aus dem Speicher am angegebenen Speicherort ab, der mit den findType Parametern übereinstimmt findValue .
Werte für storeLocation die Enumeration sind enthalten StoreLocation :
LocalMachine: der dem lokalen Computer zugewiesene Zertifikatspeicher.
CurrentUser: der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).
Wenn die Anwendung unter einem Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Anwendung unter einem Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.
Die Werte für storeName diese sind in der StoreName Enumeration enthalten.
Die Werte für findType diese sind in der X509FindType Enumeration enthalten.
Die am häufigsten verwendete Aufzählung ist FindBySubjectName, bei der bei der Suche nach dem Antragstellernamen von Zertifikaten im angegebenen Speicher die Groß-/Kleinschreibung nicht beachtet wird. Dies kann eine ungenaue Suche sein. Wenn keine Zertifikate oder mehrere Zertifikate gefunden werden, die den Kriterien entsprechen, wird ein InvalidOperationException Fehler ausgelöst.
