HttpWebRequest.ClientCertificates Właściwość
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.
Pobiera lub ustawia kolekcję certyfikatów zabezpieczeń skojarzonych z tym żądaniem.
public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); void set(System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ value); };public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, setmember this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollectionPublic Property ClientCertificates As X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionWartość właściwości
X509CertificateCollection zawierający certyfikaty zabezpieczeń skojarzone z tym żądaniem.
Wyjątki
Wartość określona dla operacji zestawu jest null.
Uwagi
Ostrożność
WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Aplikacja może dodać certyfikat do kolekcji, ale może nie mieć do niej praw dostępu. Aby użyć certyfikatu zawartego w kolekcji, aplikacja musi mieć takie same prawa dostępu jak jednostka, która wystawiła certyfikat.
Nuta
Platforma buforuje sesje SSL podczas ich tworzenia i próbuje ponownie użyć buforowanej sesji dla nowego żądania, jeśli to możliwe. Podczas próby ponownego użycia sesji SSL platforma używa pierwszego elementu ClientCertificates (jeśli istnieje) lub próbuje ponownie użyć sesji anonimowych, jeśli ClientCertificates jest pusta.
Nuta
Ze względu na wydajność nie należy dodawać certyfikatu klienta do HttpWebRequest, chyba że wiesz, że serwer go poprosi.
Przykładowy kod ilustrujący sposób wyliczania certyfikatów w magazynie certyfikatów klienta można znaleźć w klasie X509Certificate2Collection.
