X509CertificateRecipientClientCredential.SetDefaultCertificate Metoda
Definicja
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
| 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 jest używany 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 jest używany 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, która jest zgodna z określonymi parametrami.
W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat jest używany 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)
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 jest używany 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 -> unitPublic 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
subjectName to null.
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 elementu są uwzględniane w wyliczenie 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 zazwyczaj znajduje się w elemecie 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 wyliczenie StoreName .
Dotyczy
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 jest używany 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::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 -> unitPublic 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 uzyskania 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
findValue to null.
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 elementu są uwzględniane w wyliczenie 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 zazwyczaj znajduje się w elemecie 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 wyliczenie StoreName .
Wartości dla findType są uwzględniane w wyliczenie X509FindType .
Najczęściej używane wyliczenie to FindBySubjectName, co umożliwia 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, InvalidOperationException zostanie zgłoszony element .
