X509CertificateRecipientClientCredential.SetDefaultCertificate Metoda

Definicja

Przestrzeń nazw:: System.ServiceModel.Security

Zestawy:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Zestaw:: System.ServiceModel.Primitives.dll

Zestaw:: System.ServiceModel.dll

Pakiet:: System.ServiceModel.Primitives v10.0.652802

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa domyślny certyfikat do użycia dla usługi.

Przeciążenia

Nazwa	Opis
SetDefaultCertificate(String, StoreLocation, StoreName)	Określa domyślny certyfikat do użycia dla usługi. W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat służy do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Określa domyślny certyfikat do użycia dla usługi. W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat służy do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

Uwagi

Te metody pobierają certyfikat z magazynu w określonej lokalizacji zgodnej z określonymi parametrami.

W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat służy do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

SetDefaultCertificate(String, StoreLocation, StoreName)

Źródło:: X509CertificateRecipientClientCredential.cs

Źródło:: X509CertificateRecipientClientCredential.cs

Źródło:: X509CertificateRecipientClientCredential.cs

Określa domyślny certyfikat do użycia dla usługi. W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat służy do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

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

Nazwa wyróżniająca podmiotu.

storeLocation: StoreLocation

Lokalizacja magazynu certyfikatów używanego przez usługę do uzyskania certyfikatu usługi.

storeName: StoreName

Nazwa magazynu certyfikatów X.509 do otwarcia.

Wyjątki

ArgumentNullException

Parametr subjectName ma wartość null.

InvalidOperationException

Podjęto próbę ustawienia, gdy poświadczenie jest tylko do odczytu.

Przykłady

Poniższy kod używa tej metody do określenia certyfikatu X.509 do użycia.

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

Uwagi

Ta metoda pobiera certyfikat z magazynu w określonej lokalizacji zgodnej z parametrem subjectName .

Wartości dla storeLocation są uwzględniane w wyliczeniem StoreLocation :

LocalMachine: magazyn certyfikatów przypisany do komputera lokalnego.
CurrentUser: magazyn certyfikatów używany przez bieżącego użytkownika (ustawienie domyślne).

Jeśli aplikacja jest uruchomiona na koncie systemowym, certyfikat jest zwykle w programie LocalMachine. Jeśli aplikacja jest uruchomiona na koncie użytkownika, certyfikat zazwyczaj znajduje się w elemecie CurrentUser.

Wartości dla storeName są uwzględniane w wyliczeniem StoreName .

Dotyczy

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Źródło:: X509CertificateRecipientClientCredential.cs

Źródło:: X509CertificateRecipientClientCredential.cs

Źródło:: X509CertificateRecipientClientCredential.cs

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

Lokalizacja magazynu certyfikatów używana przez usługę do uzyskiwania certyfikatu usługi.

storeName: StoreName

Nazwa magazynu certyfikatów X.509 do otwarcia.

findType: X509FindType

Typ wyszukiwania X.509 do wykonania.

findValue: Object

Wartość do wyszukania w magazynie certyfikatów X.509.

Wyjątki

ArgumentNullException

Parametr findValue ma wartość null.

InvalidOperationException

Podjęto próbę ustawienia, gdy poświadczenie jest tylko do odczytu.

Przykłady

Poniższy kod używa tej metody do określenia certyfikatu X.509 do użycia.

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

Uwagi

Ta metoda pobiera certyfikat z magazynu w określonej lokalizacji zgodnej z parametrami findType i findValue .

Wartości dla storeLocation są uwzględniane w wyliczeniem StoreLocation :

LocalMachine: magazyn certyfikatów przypisany do komputera lokalnego.
CurrentUser: magazyn certyfikatów używany przez bieżącego użytkownika (ustawienie domyślne).

Wartości dla storeName są uwzględniane w wyliczeniem StoreName .

Wartości dla findType są uwzględniane w wyliczeniem X509FindType .

Najczęściej używane wyliczenie to FindBySubjectName, co wykonuje wyszukiwanie bez uwzględniania wielkości liter w nazwie podmiotu certyfikatów w określonym magazynie. Może to być nieprecyzyjne wyszukiwanie. Jeśli nie zostaną znalezione żadne certyfikaty lub wiele certyfikatów spełniających kryteria, zostanie zgłoszony element InvalidOperationException .

Dotyczy

Opinia

Czy ta strona była pomocna?