Sdílet prostřednictvím

X509CertificateRecipientClientCredential.SetScopedCertificate Metoda

  • Reference

Definice

Obor názvů:
System.ServiceModel.Security
Sestavení:
System.ServiceModel.Primitives.dll
Sestavení:
System.ServiceModel.dll

Nastaví certifikát z úložiště a uloží ho do kolekce indexované adresou URL, která nastaví obor.

Přetížení

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Nastaví certifikát podle názvu subjektu, umístění úložiště certifikátů a názvu úložiště certifikátů a uloží ho do kolekce, která se použije pro adresu URL, která nastaví obor.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Nastaví certifikát podle umístění úložiště certifikátů, názvu úložiště certifikátů, typu hledání X.509 a hodnoty, které chcete vyhledat, a uloží ho do kolekce, která se má použít pro adresu URL, která nastaví obor.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Nastaví certifikát podle názvu subjektu, umístění úložiště certifikátů a názvu úložiště certifikátů a uloží ho do kolekce, která se použije pro adresu URL, která nastaví obor.

public:
 void SetScopedCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, Uri ^ targetService);
public void SetScopedCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, Uri targetService);
member this.SetScopedCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * Uri -> unit
Public Sub SetScopedCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName, targetService As Uri)

Parametry

subjectName
String

Plně kvalifikovaný název subjektu.

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.

targetService
Uri

Adresa URL, která nastaví obor.

Výjimky

ArgumentNullException

subjectName nebo targetService je null.

InvalidOperationException

Pokusili jste se nastavit, když je přihlašovací údaje jen pro čtení.

Příklady

Tento kód ukazuje, jak tuto metodu volat.

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

Poznámky

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

  • LocalMachine: úložiště certifikátů přiřazené 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, certifikát je obvykle v LocalMachine. Pokud je aplikace spuštěná pod uživatelským účtem, certifikát je obvykle v CurrentUser.

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

Platí pro

SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Nastaví certifikát podle umístění úložiště certifikátů, názvu úložiště certifikátů, typu hledání X.509 a hodnoty, které chcete vyhledat, a uloží ho do kolekce, která se má použít pro adresu URL, která nastaví obor.

public:
 void SetScopedCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue, Uri ^ targetService);
public void SetScopedCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue, Uri targetService);
member this.SetScopedCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj * Uri -> unit
Public Sub SetScopedCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object, targetService As Uri)

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á spustit.

findValue
Object

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

targetService
Uri

Adresa URL, která nastaví obor.

Výjimky

ArgumentNullException

findValue nebo targetService je null.

InvalidOperationException

Pokusili jste se nastavit, když je přihlašovací údaje jen pro čtení.

Příklady

Tento kód ukazuje, jak tuto metodu volat.

public void snippet20(CalculatorClient client)
{
    X509CertificateRecipientClientCredential rcc = client.ClientCredentials.ServiceCertificate;
    rcc.SetScopedCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS",
                             new Uri("http://fabrikam.com/sts"));
}

rcc.SetScopedCertificate(StoreLocation.CurrentUser, _
            StoreName.TrustedPeople, _
            X509FindType.FindBySubjectName, _
            "FabrikamSTS", _
            New Uri("http://fabrikam.com/sts"))

Poznámky

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

  • LocalMachine: úložiště certifikátů přiřazené 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, certifikát je obvykle v LocalMachine. Pokud je aplikace spuštěná pod uživatelským účtem, certifikát je obvykle v CurrentUser.

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

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

Nejčastěji používaný výčet je FindBySubjectName, který nerozlišuje velká a malá písmena vyhledávání názvu subjektu certifikátů v zadaném úložišti. Může to být nepřesné hledání. Pokud nejsou nalezeny žádné certifikáty nebo více certifikátů, které odpovídají kritériím, vyvolá se chyba InvalidOperationException .

Platí pro