HttpClientHandler Clase

Definición

Controlador de mensajes predeterminado utilizado por HttpClient en .NET Framework, .NET Core 2.0 y versiones 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
Herencia
HttpClientHandler
Derivado

Ejemplos

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

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para HttpClientHandler.

Constructores

HttpClientHandler()

Crea una instancia de una clase HttpClientHandler.

Propiedades

AllowAutoRedirect

Obtiene o establece un valor que indica si el controlador debe seguir las respuestas de redirección.

AutomaticDecompression

Obtiene o establece el tipo de método de descompresión usado por el controlador para la descompresión automática de la respuesta de contenido HTTP.

CheckCertificateRevocationList

Obtiene o establece un valor que indica si el certificado se coteja con la lista de revocación de la entidad de certificación.

ClientCertificateOptions

Obtiene o establece un valor que indica si el certificado se ha seleccionado automáticamente desde el almacén de certificados o si el autor de llamada tiene permiso para pasar un certificado de cliente específico.

ClientCertificates

Obtiene la colección de certificados de seguridad asociados a las solicitudes al servidor.

CookieContainer

Obtiene o establece el contenedor de cookies utilizado para almacenar cookies de servidor por el controlador.

Credentials

Obtiene o establece la información de autenticación usada por este controlador.

DangerousAcceptAnyServerCertificateValidator

Obtiene un delegado almacenado en caché que siempre devuelve true.

DefaultProxyCredentials

Cuando se usa el proxy predeterminado (sistema), obtiene o establece las credenciales que se van a enviar al servidor proxy predeterminado para la autenticación. El proxy predeterminado se usa solo cuando UseProxy está establecido en true y Proxy está establecido en null.

MaxAutomaticRedirections

Obtiene o establece el número máximo de redirecciones que sigue el controlador.

MaxConnectionsPerServer

Obtiene o establece el número máximo de conexiones simultáneas (por punto de conexión del servidor) permitido al realizar solicitudes mediante un objeto HttpClient. Tenga en cuenta que el límite es por punto de conexión del servidor, así que, por ejemplo, un valor de 256 permitiría 256 conexiones simultáneas con http://www.adatum.com/ y otras 256 con http://www.adventure-works.com/.

MaxRequestContentBufferSize

Obtiene o establece el tamaño de búfer de contenido de solicitud máximo utilizado por el controlador.

MaxResponseHeadersLength

Obtiene o establece la longitud máxima, en kilobytes (1024 bytes), de los encabezados de respuesta. Por ejemplo, si el valor es 64, se permiten 65536 bytes como longitud máxima de los encabezados de respuesta.

MeterFactory

Obtiene o establece el objeto para IMeterFactory crear un personalizado Meter para la HttpClientHandler instancia de .

PreAuthenticate

Obtiene o establece un valor que indica si el controlador envía un encabezado de autorización con la solicitud.

Properties

Obtiene un diccionario que permite la escritura (es decir, un mapa) de propiedades personalizadas para las solicitudes HttpClient. El diccionario se inicializa vacío; puede insertar y consultar pares clave-valor para los controladores personalizados y el procesamiento especial.

Proxy

Obtiene o establece la información de proxy usada por el controlador.

ServerCertificateCustomValidationCallback

Obtiene o establece un método de devolución de llamada para validar el certificado de servidor.

SslProtocols

Obtiene o establece el protocolo TLS/SSL usado por los objetos HttpClient administrados por el objeto HttpClientHandler.

SupportsAutomaticDecompression

Obtiene un valor que indica si el controlador admite descompresión de contenido de respuesta automática.

SupportsProxy

Obtiene un valor que indica si el controlador admite la configuración de proxy.

SupportsRedirectConfiguration

Obtiene un valor que indica si el controlador admite opciones de configuración para las propiedades AllowAutoRedirect y MaxAutomaticRedirections.

UseCookies

Obtiene o establece un valor que indica si el controlador utiliza la CookieContainer propiedad para almacenar las cookies del servidor y utiliza estas cookies al enviar solicitudes.

UseDefaultCredentials

Obtiene o establece un valor que controla si el identificador envía las credenciales predeterminadas con las solicitudes.

UseProxy

Obtiene o establece un valor que indica si el controlador usa un proxy para las solicitudes.

Métodos

Dispose()

Libera los recursos no administrados y desecha los recursos administrados que usa HttpMessageHandler.

(Heredado de HttpMessageHandler)
Dispose(Boolean)

Libera los recursos no administrados que usa el objeto HttpClientHandler y, de forma opcional, desecha los recursos administrados.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
Send(HttpRequestMessage, CancellationToken)

Crea una instancia de en función de HttpResponseMessage la información proporcionada en .HttpRequestMessage

Send(HttpRequestMessage, CancellationToken)

Cuando se invalida en una clase derivada, envía una solicitud HTTP con el token de cancelación y la solicitud especificados. En caso contrario, produce una excepción NotSupportedException.

(Heredado de HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)

Crea una instancia de HttpResponseMessage basada en la información proporcionada en HttpRequestMessage como una operación que no se bloqueará.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también