HttpClientHandler Класс

Определение

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

System.Net.Http

Сборки:

netstandard.dll, System.Net.Http.dll

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

HttpClientHandler.cs

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

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	Когда используется прокси-сервер по умолчанию (система), получает или задает учетные данные для отправки на прокси-сервер по умолчанию для проверки подлинности. Прокси по умолчанию используется только в том случае, если UseProxytrue задано значение и 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)

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

• Подключение к веб-службе
• Краткое руководство. Подключение с помощью HttpClient
• Использование обработчиков HttpClient
• Защита подключений HttpClient