HttpWebRequest.ClientCertificates Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 obsahující certifikáty zabezpečení přidružené k tomuto požadavku.
Výjimky
Hodnota zadaná pro operaci sady je null
.
Poznámky
Opatrnost
WebRequest
, HttpWebRequest
, ServicePoint
a 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ě.