HttpClientHandler Класс

Определение

Пространство имен:

System.Net.Http

Сборка:

System.Net.Http.dll

Исходный код:

HttpClientHandler.cs

Обработчик сообщений по умолчанию, используемый HttpClient в .NET Framework и .NET Core 2.0 и более ранней версии.

public ref class HttpClientHandler : System::Net::Http::HttpMessageHandler

public class HttpClientHandler : System.Net.Http.HttpMessageHandler

type HttpClientHandler = class
    inherit HttpMessageHandler

Public Class HttpClientHandler
Inherits HttpMessageHandler

Наследование

Object

HttpMessageHandler

HttpClientHandler

Производный

System.Net.Http.WebRequestHandler

Примеры

static async Task Main()
{
   // Create an HttpClientHandler object and set to use default credentials
   HttpClientHandler handler = new HttpClientHandler();
   handler.UseDefaultCredentials = true;

   // Create an HttpClient object
   HttpClient client = new HttpClient(handler);

   // Call asynchronous network methods in a try/catch block to handle exceptions
   try
   {
      HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");

      response.EnsureSuccessStatusCode();

      string responseBody = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseBody);
   }
   catch(HttpRequestException e)
   {
       Console.WriteLine("\nException Caught!");
       Console.WriteLine("Message :{0} ",e.Message);
   }

   // Need to call dispose on the HttpClient and HttpClientHandler objects
   // when done using them, so the app doesn't leak resources
   handler.Dispose();
   client.Dispose();
}

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для HttpClientHandler.

Конструкторы

HttpClientHandler()

Создает экземпляр класса HttpClientHandler.

Свойства

AllowAutoRedirect	Возвращает или задает значение, которое указывает, должен ли обработчик следовать ответам перенаправления.
AutomaticDecompression	Возвращает или задает тип метода распаковки, используемый обработчиком для автоматической распаковки содержимого HTTP-ответа.
CheckCertificateRevocationList	Получает или задает значение, указывающее, проверяется ли сертификат по списку отзыва центра сертификации.
ClientCertificateOptions	Возвращает или задает значение, указывающее, выбирается ли автоматически сертификат из хранилища сертификатов, или может ли вызывающий объект передавать определенный клиентский сертификат.
ClientCertificates	Возвращает коллекцию сертификатов безопасности, связанных с запросами к серверу.
CookieContainer	Возвращает или задает контейнер файлов cookie, используемый для хранения файлов cookie сервера обработчиком.
Credentials	Возвращает или задает сведения о проверке подлинности, используемые данным обработчиком.
DangerousAcceptAnyServerCertificateValidator	Получает кэшированный делегат, который всегда возвращает true.
DefaultProxyCredentials	Если используется прокси-сервер по умолчанию (системный), возвращает или задает учетные данные, отправляемые на прокси-сервер по умолчанию для проверки подлинности. Прокси-сервер по умолчанию используется только если UseProxy задано значение true и Proxy задано значение null.
MaxAutomaticRedirections	Возвращает или задает максимальное количество переадресаций, выполняемых обработчиком.
MaxConnectionsPerServer	Возвращает или задает максимально допустимое число одновременных подключений (для каждой конечной точки сервера) при выполнении запросов с помощью объекта HttpClient. Обратите внимание, что для каждой конечной точки сервера существует ограничение, например, значение 256 разрешает выполнять 256 одновременных подключений к http://www.adatum.com/ и еще 256 подключений — к http://www.adventure-works.com/.
MaxRequestContentBufferSize	Получает или задает максимальный размер буфера содержимого запроса, используемого обработчиком.
MaxResponseHeadersLength	Возвращает или задает максимальную длину заголовков ответов, выраженную в килобайтах (1024 байта). Например, если значение равно 64, для максимальной длины заголовков ответов разрешено использовать 65536 байт.
MeterFactory	Возвращает или задает объект для IMeterFactory создания пользовательского Meter объекта для экземпляра HttpClientHandler .
PreAuthenticate	Получает или задает значение, указывающее, будет ли обработчик отправлять заголовок авторизации вместе с запросом.
Properties	Возвращает доступный для записи словарь (т. е. карту) настраиваемых свойств запросов HttpClient. Словарь инициализируется пустым. Можно вставить и запросить пары "ключ-значение" для пользовательских обработчиков и особой обработки.
Proxy	Возвращает или задает сведения о прокси-сервере, используемые обработчиком.
ServerCertificateCustomValidationCallback	Получает или задает метод обратного вызова для проверки сертификата сервера.
SslProtocols	Возвращает или задает протокол TLS/SSL, используемый объектами HttpClient, которые управляются объектом HttpClientHandler.
SupportsAutomaticDecompression	Возвращает значение, указывающее, поддерживает ли обработчик автоматическую распаковку содержимого ответов.
SupportsProxy	Получает значение, указывающее, поддерживает ли обработчик параметры прокси.
SupportsRedirectConfiguration	Получает значение, указывающее, поддерживает ли обработчик параметры конфигурации для свойств AllowAutoRedirect и MaxAutomaticRedirections.
UseCookies	Возвращает или задает значение, указывающее, использует CookieContainer ли обработчик свойство для хранения файлов cookie сервера и использует ли эти файлы cookie при отправке запросов.
UseDefaultCredentials	Получает или задает значение, которое управляет отправкой обработчиком учетных данных по умолчанию вместе с запросами.
UseProxy	Возвращает или задает значение, указывающее, использует ли обработчик прокси-сервер для запросов.

Методы

Dispose()	Освобождает неуправляемые ресурсы и удаляет управляемые ресурсы, используемые объектом HttpMessageHandler. (Унаследовано от HttpMessageHandler)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом HttpClientHandler, и опционально удаляет управляемые ресурсы.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Send(HttpRequestMessage, CancellationToken)	Создает экземпляр на HttpResponseMessage основе сведений, предоставленных HttpRequestMessageв .
SendAsync(HttpRequestMessage, CancellationToken)	Создает экземпляр на основе сведений HttpResponseMessage , предоставленных в , HttpRequestMessage как операция, которая не блокируется.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Connecting to a web service (Соединение с веб-службой)
• Краткое руководство. Подключение с помощью HttpClient
• How to use HttpClient handlers (Как использовать обработчики HttpClient)
• How to secure HttpClient connections (Как защитить подключения HttpClient)
• Пример HttpClient