HttpClientHandler Classe

Definição

Espaço de Nomes:
System.Net.Http
Assemblagem:
System.Net.Http.dll
Assemblagem:
netstandard.dll

O manipulador de mensagens predefinido usado por HttpClient no .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

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

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para HttpClientHandler.

Construtores

Name Description
HttpClientHandler()

Cria uma instância de uma HttpClientHandler classe.

Propriedades

Name Description
AllowAutoRedirect

Recebe ou define um valor que indica se o manipulador deve seguir respostas de redirecionamento.
AutomaticDecompression

Obtém ou define o tipo de método de descompressão usado pelo handler para a descompressão automática da resposta de conteúdo HTTP.
CheckCertificateRevocationList

Recebe ou define um valor que indica se o certificado está verificado na lista de revogação da autoridade certificadora.
ClientCertificateOptions

Recebe ou define um valor que indica se o certificado é automaticamente selecionado do armazenamento de certificados ou se o chamador pode passar um certificado cliente específico.
ClientCertificates

Obtém a coleção de certificados de segurança associados aos pedidos ao servidor.
CookieContainer

Obtém ou define o contentor de cookies usado para armazenar os cookies do servidor pelo handler.
Credentials

Obtém ou define a informação de autenticação usada por este handler.
DangerousAcceptAnyServerCertificateValidator

Recebe um delegado em cache que devolve truesempre.
DefaultProxyCredentials

Quando o proxy padrão (do sistema) está a ser utilizado, obtém ou define as credenciais para serem submetidas ao servidor proxy predefinido para autenticação. O proxy por defeito é usado apenas quando UseProxy está definido como true e Proxy está 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 ligações concorrentes permitidas (por endpoint servidor) ao fazer pedidos usando um HttpClient objeto. Note que o limite é por endpoint do servidor, por isso, por exemplo, um valor de 256 permitiria 256 ligações concorrentes a http://www.adatum.com/ e outras 256 a http://www.adventure-works.com/.
MaxRequestContentBufferSize

Obtém ou define o tamanho máximo do buffer de conteúdo de pedidos usado pelo handler.
MaxResponseHeadersLength

Obtém ou define o comprimento máximo, em kilobytes (1024 bytes), dos cabeçalhos de resposta. Por exemplo, se o valor for 64, então são permitidos 65536 bytes para o comprimento máximo dos cabeçalhos de resposta.
PreAuthenticate

Recebe ou define um valor que indica se o handler envia um cabeçalho de Autorização com o pedido.
Properties

Obtém um dicionário gravável (ou seja, um mapa) de propriedades personalizadas para os HttpClient pedidos. O dicionário é inicializado vazio; Podes inserir e consultar pares chave-valor para os teus handlers personalizados e processamento especial.
Proxy

Obtém ou define a informação proxy usada pelo handler.
ServerCertificateCustomValidationCallback

Recebe ou define um método de callback para validar o certificado do servidor.
SslProtocols

Obtém ou define os protocolos TLS/SSL usados pelos HttpClient objetos geridos pelo objeto HttpClientHandler.
SupportsAutomaticDecompression

Obtém um valor que indica se o handler suporta descompressão automática de conteúdo de resposta.
SupportsProxy

Recebe um valor que indica se o handler suporta definições de proxy.
SupportsRedirectConfiguration

Recebe um valor que indica se o handler suporta definições de configuração para as AllowAutoRedirect propriedades e MaxAutomaticRedirections .
UseCookies

Recebe ou define um valor que indica se o handler usa a CookieContainer propriedade para armazenar cookies do servidor e usa esses cookies ao enviar pedidos.
UseDefaultCredentials

Recebe ou define um valor que controla se as credenciais padrão são enviadas com pedidos pelo handler.
UseProxy

Recebe ou define um valor que indica se o handler usa um proxy para pedidos.

Métodos

Name Description
Dispose()

Liberta os recursos não geridos e dispõe dos recursos geridos usados pelo HttpMessageHandler.

(Herdado de HttpMessageHandler)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo HttpClientHandler e opcionalmente elimina os recursos geridos.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
SendAsync(HttpRequestMessage, CancellationToken)

Cria uma instância de HttpResponseMessage baseada na informação fornecida no HttpRequestMessage como uma operação que não irá bloquear.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também