HttpClientHandler Classe

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Origem:

HttpClientHandler.cs

O manipulador de mensagens padrão usado pelo HttpClient no .NET Framework e .NET Core 2.0 e versões anteriores.

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

Herança

Object

HttpMessageHandler

HttpClientHandler

Derivado

System.Net.Http.WebRequestHandler

Exemplos

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();
}

Comentários

Para obter mais informações sobre essa API, consulte Comentários da API complementar para HttpClientHandler.

Construtores

HttpClientHandler()

Cria uma instância de uma classe HttpClientHandler.

Propriedades

AllowAutoRedirect	Obtém ou define um valor que indica se o manipulador deve seguir as respostas de redirecionamento.
AutomaticDecompression	Obtém ou define o tipo de método de descompactação usado pelo manipulador para descompactação automática da resposta de conteúdo HTTP.
CheckCertificateRevocationList	Obtém ou define um valor que indica se o certificado é verificado em relação à lista de revogação de autoridade de certificação.
ClientCertificateOptions	Obtém ou define um valor que indica se o certificado é selecionado automaticamente do repositório de certificados ou se o chamador tem permissão para passar um certificado do cliente específico.
ClientCertificates	Obtém a coleção de certificados de segurança associados a solicitações para o servidor.
CookieContainer	Obtém ou define o contêiner de cookies usado para armazenar cookies de servidor pelo manipulador.
Credentials	Obtém ou define informações de autenticação usadas por este manipulador.
DangerousAcceptAnyServerCertificateValidator	Obtém um delegado em cache que sempre retorna true.
DefaultProxyCredentials	Quando o proxy padrão (sistema) está sendo usado, obtém ou define as credenciais a serem enviadas ao servidor proxy padrão para autenticação. O proxy padrão é usado apenas quando UseProxy é definido como true e Proxy é definido como null.
MaxAutomaticRedirections	Obtém ou define o número máximo de redirecionamentos que o manipulador segue.
MaxConnectionsPerServer	Obtém ou define o número máximo de conexões simultâneas (por ponto de extremidade do servidor) permitidas ao fazer solicitações usando um objeto HttpClient. Observe que o limite é por ponto de extremidade do servidor, portanto, por exemplo, um valor de 256 permitiria 256 conexões simultâneas com http://www.adatum.com/ e outras 256 com http://www.adventure-works.com/.
MaxRequestContentBufferSize	Obtém ou define o tamanho máximo do buffer de conteúdo de solicitação usado pelo manipulador.
MaxResponseHeadersLength	Obtém ou define o comprimento máximo, em quilobytes (1024 bytes), dos cabeçalhos de resposta. Por exemplo, se o valor é 64, 65.536 bytes são permitidos para o comprimento máximo dos cabeçalhos de resposta.
MeterFactory	Obtém ou define o IMeterFactory para criar um personalizado Meter para a HttpClientHandler instância.
PreAuthenticate	Obtém ou define um valor que indica se o manipulador envia um cabeçalho de autorização com a solicitação.
Properties	Obtém um dicionário gravável (ou seja, um mapa) de propriedades personalizadas para as solicitações de HttpClient. O dicionário é inicializado vazio. Você pode inserir e consultar pares chave-valor para seus manipuladores personalizados e processamento especial.
Proxy	Obtém ou define as informações de proxy usadas pelo manipulador.
ServerCertificateCustomValidationCallback	Obtém ou define um método de retorno de chamada para validar o certificado do servidor.
SslProtocols	Obtém ou define o protocolo TLS/SSL usado pelos objetos HttpClient gerenciados pelo objeto HttpClientHandler.
SupportsAutomaticDecompression	Obtém um valor que indica se o manipulador dá suporte a descompactação de conteúdo de resposta automática.
SupportsProxy	Obtém um valor que indica se o manipulador dá suporte a configurações de proxy.
SupportsRedirectConfiguration	Obtém um valor que indica se o manipulador dá ou não suporte a definições de configuração para as propriedades AllowAutoRedirect e MaxAutomaticRedirections.
UseCookies	Obtém ou define um valor que indica se o manipulador usa a CookieContainer propriedade para armazenar cookies de servidor e usa esses cookies ao enviar solicitações.
UseDefaultCredentials	Obtém ou define um valor que controla se as credenciais padrão são enviadas com solicitações pelo manipulador.
UseProxy	Obtém ou define um valor que indica se o manipulador usa um proxy para solicitações.

Métodos

Dispose()	Libera os recursos não gerenciados e descarta aqueles gerenciados usados pelo HttpMessageHandler. (Herdado de HttpMessageHandler)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo HttpClientHandler e, opcionalmente, descarta os recursos gerenciados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Send(HttpRequestMessage, CancellationToken)	Cria uma instância de HttpResponseMessage com base nas informações fornecidas no HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Cria uma instância de HttpResponseMessage com base nas informações fornecidas no HttpRequestMessage como uma operação que não será bloqueada.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Conectando-se a um serviço Web
• Início Rápido: Conectando-se usando HttpClient
• Como usar manipuladores HttpClient
• Como proteger conexões HttpClient
• Amostra de HttpClient