HttpWebRequest.ClientCertificates Vlastnost

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.Requests.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
HttpWebRequest.cs
Zdroj:
HttpWebRequest.cs
Zdroj:
HttpWebRequest.cs

Získá nebo nastaví kolekci certifikátů zabezpečení, které jsou přidružené k tomuto požadavku.

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, set
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public Property ClientCertificates As X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

Hodnota vlastnosti

X509CertificateCollection

X509CertificateCollection obsahující certifikáty zabezpečení přidružené k tomuto požadavku.

Výjimky

ArgumentNullException

Hodnota zadaná pro operaci sady je null.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Aplikace může přidat certifikát do kolekce, ale nemusí k ní mít přístupová práva. Pokud chcete použít certifikát obsažený v kolekci, musí mít aplikace stejná přístupová práva jako entita, která certifikát vydala.

Poznámka

Rozhraní ukládá relace SSL do mezipaměti při jejich vytváření a pokud je to možné, pokusí se znovu použít relaci uloženou v mezipaměti pro nový požadavek. Při pokusu o opětovné použití relace PROTOKOLU SSL používá framework první prvek ClientCertificates (pokud existuje) nebo se pokusí znovu použít anonymní relace, pokud ClientCertificates je prázdný.

Poznámka

Z důvodů výkonu byste neměli přidávat klientský certifikát do HttpWebRequest, pokud nevíte, že o něj server požádá.

Příklad kódu znázorňující, jak vytvořit výčet certifikátů v úložišti klientských certifikátů, najdete v X509Certificate2Collection třídě.

Platí pro