HttpClientHandler Clase

Definición

Espacio de nombres:

System.Net.Http

Ensamblado:

System.Net.Http.dll

Source:

HttpClientHandler.cs

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

Object

HttpMessageHandler

HttpClientHandler

Derivado

System.Net.Http.WebRequestHandler

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
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)

Consulte también

• Conectar con un servicio web
• Inicio rápido: Conexión mediante HttpClient
• Cómo usar controladores HttpClient
• Cómo proteger conexiones HttpClient
• Ejemplo de HttpClient