Поделиться через

HttpWebRequest.ClientCertificates Свойство

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.Requests.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
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.

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

Заметка

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

Заметка

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

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

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