Sdílet prostřednictvím


X509CertificateRecipientClientCredential.SetDefaultCertificate Metoda

Definice

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)

Zdroj:
X509CertificateRecipientClientCredential.cs
Zdroj:
X509CertificateRecipientClientCredential.cs
Zdroj:
X509CertificateRecipientClientCredential.cs

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

subjectName je null.

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 .

Platí pro

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Zdroj:
X509CertificateRecipientClientCredential.cs
Zdroj:
X509CertificateRecipientClientCredential.cs
Zdroj:
X509CertificateRecipientClientCredential.cs

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

findValue je null.

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.

Platí pro