Partilhar via


HttpClientHandler Classe

Definição

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
HttpClientHandler
Derivado

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.

Send(HttpRequestMessage, CancellationToken)

Quando substituído em uma classe derivada, envia uma solicitação HTTP com a solicitação e o token de cancelamento especificados. Caso contrário, gerará um NotSupportedException.

(Herdado de HttpMessageHandler)
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)

Aplica-se a

Confira também