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


HttpClientHandler Класс

Определение

Обработчик сообщений по умолчанию, используемый 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
Наследование
HttpClientHandler
Производный

Примеры

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в .

Send(HttpRequestMessage, CancellationToken)

При переопределении в производном классе отправляет HTTP-запрос с указанным запросом и маркером отмены. В противном случае создается исключение NotSupportedException.

(Унаследовано от HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)

Создает экземпляр на основе сведений HttpResponseMessage , предоставленных в , HttpRequestMessage как операция, которая не блокируется.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

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

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