HttpClientHandler Classe

Definição

Namespace:

System.Net.Http

Assemblies:

netstandard.dll, System.Net.Http.dll

Origem:

HttpClientHandler.cs

O manipulador de mensagens padrão usado pelo 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

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

Nome	Description
HttpClientHandler()	Cria uma instância de uma HttpClientHandler classe.

Propriedades

Nome	Description
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 na lista de revogação da autoridade de certificação.
ClientCertificateOptions	Obtém ou define um valor que indica se o certificado é escolhido automaticamente no repositório de certificados ou se o chamador tem permissão para passar um certificado de cliente específico.
ClientCertificates	Obtém a coleção de certificados de segurança associados a solicitações ao servidor.
CookieContainer	Obtém ou define o contêiner de cookie usado para armazenar cookies de servidor pelo manipulador.
Credentials	Obtém ou define as informações de autenticação usadas por esse manipulador.
DangerousAcceptAnyServerCertificateValidator	Obtém um delegado armazenado 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 somente quando UseProxy é definido true como .Proxynull
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 HttpClient objeto. Observe que o limite é por ponto de extremidade de servidor, portanto, por exemplo, um valor de 256 permitiria 256 conexões simultâneas e outras http://www.adatum.com/ 256 para http://www.adventure-works.com/.
MaxRequestContentBufferSize	Obtém ou define o tamanho máximo do buffer de conteúdo da 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 for 64, 65536 bytes serão permitidos para o comprimento máximo dos cabeçalhos de resposta.
MeterFactory	Obtém ou define a IMeterFactory criação de 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 HttpClient solicitações. 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 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 os protocolos TLS/SSL usados pelos HttpClient objetos gerenciados pelo objeto HttpClientHandler.
SupportsAutomaticDecompression	Obtém um valor que indica se o manipulador dá suporte à descompactação automática de conteúdo de resposta.
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á suporte a configurações para as propriedades e MaxAutomaticRedirections as AllowAutoRedirect propriedades.
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

Nome	Description
Dispose()	Libera os recursos não gerenciados e descarta os recursos gerenciados usados pelo HttpMessageHandler. (Herdado de HttpMessageHandler)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelos HttpClientHandler recursos gerenciados e, opcionalmente, descartados.
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 Objectatual. (Herdado de Object)
Send(HttpRequestMessage, CancellationToken)	Cria uma instância com HttpResponseMessage base nas informações fornecidas no HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Cria uma instância com HttpResponseMessage base nas informações fornecidas na HttpRequestMessage operação 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