X509CertificateRecipientClientCredential.SetDefaultCertificate Metoda

Definice

Obor názvů:

System.ServiceModel.Security

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v8.0.0

Určuje výchozí certifikát, který se má použít pro službu.

Přetížení

SetDefaultCertificate(String, StoreLocation, StoreName)	Určuje výchozí certifikát, který se má použít pro službu. Pro vazby, které používají zabezpečení zpráv na základě certifikátu, se tento certifikát používá k šifrování zpráv službě a očekává se, že ho služba použije k podepisování odpovědí klientovi.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Určuje výchozí certifikát, který se má použít pro službu. Pro vazby, které používají zabezpečení zpráv na základě certifikátu, se tento certifikát používá k šifrování zpráv službě a očekává se, že ho služba použije k podepisování odpovědí klientovi.

Poznámky

Tyto metody získají certifikát z úložiště v zadaném umístění, který odpovídá zadaným parametrům.

Pro vazby, které používají zabezpečení zpráv na základě certifikátu, se tento certifikát používá k šifrování zpráv službě a očekává se, že ho služba použije k podepisování odpovědí klientovi.

SetDefaultCertificate(String, StoreLocation, StoreName)

Určuje výchozí certifikát, který se má použít pro službu. Pro vazby, které používají zabezpečení zpráv na základě certifikátu, se tento certifikát používá k šifrování zpráv službě a očekává se, že ho služba použije k podepisování odpovědí klientovi.

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)

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 služby.

storeName

StoreName

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

Výjimky

ArgumentNullException

subjectName je null.

InvalidOperationException

Došlo k pokusu o nastavení, pokud jsou přihlašovací údaje jen pro čtení.

Příklady

Následující kód používá tuto metodu k určení certifikátu X.509, který se má použít.

public void snippet23(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate("http://fabrikam.com/sts",
                             StoreLocation.CurrentUser,
                             StoreName.TrustedPeople);
}

Poznámky

Tato metoda získá certifikát z úložiště v zadaném umístění, který odpovídá parametru 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.

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

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 .

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Určuje výchozí certifikát, který se má použít pro službu. Pro vazby, které používají zabezpečení zpráv na základě certifikátu, se tento certifikát používá k šifrování zpráv službě a očekává se, že ho služba použije k podepisování odpovědí klientovi.

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)

Parametry

storeLocation

StoreLocation

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

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.

Výjimky

ArgumentNullException

findValue je null.

InvalidOperationException

Došlo k pokusu o nastavení, pokud jsou přihlašovací údaje jen pro čtení.

Příklady

Následující kód používá tuto metodu k určení certifikátu X.509, který se má použít.

public void snippet22(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS");
}

Poznámky

Tato metoda získá certifikát z úložiště v zadaném umístění, který odpovídá parametrům findType a findValue .

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.

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

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.