HttpWebRequest.ClientCertificates Свойство

Определение

Пространство имен:
System.Net
Сборки:
netstandard.dll, System.Net.Requests.dll
Сборка:
System.Net.Requests.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
HttpWebRequest.cs
Исходный код:
HttpWebRequest.cs
Исходный код:
HttpWebRequest.cs
Исходный код:
HttpWebRequest.cs
Исходный код:
HttpWebRequest.cs

Возвращает или задает коллекцию сертификатов безопасности, связанных с этим запросом.

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

Значение свойства

X509CertificateCollection

Идентификатор X509CertificateCollection , содержащий сертификаты безопасности, связанные с этим запросом.

Исключения

ArgumentNullException

Значением, указанным для операции набора, является null.

Комментарии

Предостережение

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Приложение может добавить сертификат в коллекцию, но может не иметь прав доступа к нему. Чтобы использовать сертификат, содержащийся в коллекции, приложение должно иметь те же права доступа, что и сущность, выдавающая сертификат.

Note

Платформа кэширует сеансы SSL по мере их создания и пытается повторно использовать кэшированный сеанс для нового запроса, если это возможно. При попытке повторного использования сеанса SSL платформа использует первый элемент ClientCertificates (если есть один), или пытается повторно использовать анонимные сеансы, если ClientCertificates он пуст.

Note

По соображениям производительности не следует добавлять сертификат клиента в сертификат HttpWebRequest клиента, если вы не знаете, что сервер будет запрашивать его.

Пример кода, демонстрирующий перечисление сертификатов в хранилище сертификатов клиента, см. в X509Certificate2Collection этом классе.

Применяется к