Freigeben über

X509CertificateRecipientClientCredential.SetDefaultCertificate Methode

  • Referenz

Definition

Namespace:
System.ServiceModel.Security
Assembly:
System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.dll
Paket:
System.ServiceModel.Primitives v8.0.0

Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll.

Überlädt

SetDefaultCertificate(String, StoreLocation, StoreName)

Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.

Hinweise

Diese Methoden rufen ein Zertifikat vom Speicher am angegebenen Speicherort ab, das mit den angegebenen Parametern übereinstimmt.

Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.

SetDefaultCertificate(String, StoreLocation, StoreName)

Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs

Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.

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)

Parameter

subjectName
String

Distinguished Name des Antragstellers.

storeLocation
StoreLocation

Der Speicherort des Zertifikatsspeichers, den der Dienst zum Abrufen des Dienstzertifikats verwendet.

storeName
StoreName

Der Name des X.509-Zertifikatsspeichers, der geöffnet werden soll.

Ausnahmen

ArgumentNullException

subjectName ist null.

InvalidOperationException

Dies wurde versucht festzulegen, obwohl die Anmeldeinformationen schreibgeschützt sind.

Beispiele

Im folgenden Code wird diese Methode verwendet, um ein zu verwendendes 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 vom Speicher am angegebenen Speicherort ab, das mit dem subjectName-Parameter übereinstimmt.

Werte für storeLocation sind in der StoreLocation-Enumeration enthalten:

  • LocalMachine: Der Zertifikatspeicher, der dem lokalen Computer zugewiesen ist.

  • CurrentUser: Der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).

Wenn die Anwendung über ein Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Anwendung über ein Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.

Werte für storeName sind in der StoreName-Enumeration enthalten.

Gilt für:

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs

Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.

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)

Parameter

storeLocation
StoreLocation

Der Speicherort des Zertifikatspeichers, den der Dienst zum Abrufen des Dienstzertifikats verwendet.

storeName
StoreName

Der Name des X.509-Zertifikatsspeichers, der geöffnet werden soll.

findType
X509FindType

Der Typ der X.509-Suche, der ausgeführt werden soll.

findValue
Object

Der Wert, nach dem im X.509-Zertifikatspeicher gesucht werden soll.

Ausnahmen

ArgumentNullException

findValue ist null.

InvalidOperationException

Dies wurde versucht festzulegen, obwohl die Anmeldeinformationen schreibgeschützt sind.

Beispiele

Im folgenden Code wird diese Methode verwendet, um ein zu verwendendes 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 vom Speicher am angegebenen Speicherort ab, das mit dem findType-Parameter und findValue-Parameter übereinstimmt.

Werte für storeLocation sind in der StoreLocation-Enumeration enthalten:

  • LocalMachine: Der Zertifikatspeicher, der dem lokalen Computer zugewiesen ist.

  • CurrentUser: Der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).

Wenn die Anwendung über ein Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Anwendung über ein Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.

Werte für storeName sind in der StoreName-Enumeration enthalten.

Werte für findType sind in der X509FindType-Enumeration enthalten.

Die am häufigsten verwendete Enumeration ist FindBySubjectName, die eine Suche in den Betreffnamen der Zertifikate im angegebenen Speicher durchführt, wobei zwischen Groß- und Kleinschreibung unterschieden wird. Dies kann eine ungenaue Suche sein. Wenn keine Zertifikate oder mehrere Zertifikate, die mit den Kriterien übereinstimmen, gefunden werden, wird InvalidOperationException ausgegeben.

Gilt für: