X509CertificateInitiatorServiceCredential.SetCertificate Metoda

Definice

Obor názvů:

System.ServiceModel.Security

Sestavení:

System.ServiceModel.dll

Nastaví certifikát, který se má použít k šifrování zpráv odeslaných službou klientovi. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.

Přetížení

SetCertificate(String, StoreLocation, StoreName)	Umožňuje určit certifikát, který se má použít k šifrování zpráv pro klienta, zadáním rozlišujícího názvu předmětu. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.
SetCertificate(StoreLocation, StoreName, X509FindType, Object)	Určuje certifikát, který se má použít k šifrování zpráv pro klienta. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.

SetCertificate(String, StoreLocation, StoreName)

Umožňuje určit certifikát, který se má použít k šifrování zpráv pro klienta, zadáním rozlišujícího názvu předmětu. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.

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

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

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

Public Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

Parametry

subjectName

String

Rozlišující název předmětu.

storeLocation

StoreLocation

Umístění úložiště certifikátů, které služba používá k získání certifikátu.

storeName

StoreName

Název úložiště certifikátů X.509, které se má otevřít.

Příklady

Následující kód ukazuje, jak pomocí této metody nastavit certifikát.

Poznámky

Další informace o parametru najdete v subjectName tématu SubjectName.

Hodnoty pro storeLocation jsou zahrnuty ve výčtu StoreLocation :

• LocalMachine: úložiště certifikátů přiřazené k místnímu počítači (výchozí).

• CurrentUser: úložiště certifikátů používané aktuálním uživatelem.

Pokud klientská aplikace běží pod systémovým účtem, je certifikát obvykle v LocalMachine. Pokud klientská aplikace běží pod uživatelským účtem, je certifikát obvykle v CurrentUser.

Hodnoty pro storeName jsou zahrnuty ve výčtu StoreName .

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

Určuje certifikát, který se má použít k šifrování zpráv pro klienta. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.

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

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

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

Public Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

Parametry

storeLocation

StoreLocation

Umístění úložiště certifikátů, které služba používá k získání certifikátu.

storeName

StoreName

Název úložiště certifikátů X.509, které se má otevřít.

findType

X509FindType

Typ vyhledávání X.509, který se má provést.

findValue

Object

Hodnota, kterou chcete vyhledat v úložišti certifikátů X.509.

Příklady

Následující kód ukazuje, jak pomocí této metody nastavit certifikát.

Poznámky

Hodnoty pro storeLocation jsou zahrnuty ve výčtu StoreLocation :

• LocalMachine: úložiště certifikátů přiřazené k místnímu počítači (výchozí).

• CurrentUser: úložiště certifikátů používané aktuálním uživatelem.

Pokud je aplikace spuštěná pod systémovým účtem, je certifikát obvykle v LocalMachine. Pokud je aplikace spuštěná pod uživatelským účtem, je certifikát obvykle v CurrentUser.

Hodnoty pro storeName jsou zahrnuty ve výčtu StoreName .

Hodnoty pro findType jsou zahrnuty ve výčtu X509FindType .

Nejčastěji používaný výčet je FindBySubjectName, který provádí vyhledávání bez rozlišování velkých a malých písmen v názvu subjektu certifikátů v zadaném úložišti. Může se jednat o nepřesné hledání. Pokud nejsou nalezeny žádné certifikáty nebo více certifikátů, které splňují kritéria, InvalidOperationException je vyvolán.