HttpClientHandler Clase

Definición

Espacio de nombres:

System.Net.Http

Ensamblados:

netstandard.dll, System.Net.Http.dll

Source:

HttpClientHandler.cs

Controlador de mensajes predeterminado usado por HttpClient en .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

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 api para HttpClientHandler.

Constructores

Nombre	Description
HttpClientHandler()	Crea una instancia de una HttpClientHandler clase .

Propiedades

Nombre	Description
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 utilizado 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 comprueba en la lista de revocación de la entidad de certificación.
ClientCertificateOptions	Obtiene o establece un valor que indica si el certificado se selecciona automáticamente del almacén de certificados o si el autor de la llamada puede 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 utilizada 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 solo se usa cuando UseProxy se establece true en y Proxy se establece en null.
MaxAutomaticRedirections	Obtiene o establece el número máximo de redireccionamientos que sigue el controlador.
MaxConnectionsPerServer	Obtiene o establece el número máximo de conexiones simultáneas (por punto de conexión de servidor) permitidas al realizar solicitudes mediante un HttpClient objeto . Tenga en cuenta que el límite es por punto de conexión de servidor, por lo que, por ejemplo, un valor de 256 permitiría 256 conexiones simultáneas a http://www.adatum.com/ y otras 256 a http://www.adventure-works.com/.
MaxRequestContentBufferSize	Obtiene o establece el tamaño máximo del búfer de contenido de solicitud 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 para la longitud máxima de los encabezados de respuesta.
MeterFactory	Obtiene o establece el objeto IMeterFactory para crear un personalizado Meter para la HttpClientHandler instancia de .
PreAuthenticate	Obtiene o establece un valor que indica si el controlador envía un encabezado authorization con la solicitud.
Properties	Obtiene un diccionario grabable (es decir, un mapa) de propiedades personalizadas para las HttpClient solicitudes. 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 utilizada 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 los protocolos TLS/SSL utilizados por los HttpClient objetos administrados por el objeto HttpClientHandler.
SupportsAutomaticDecompression	Obtiene un valor que indica si el controlador admite la descompresión automática del contenido de respuesta.
SupportsProxy	Obtiene un valor que indica si el controlador admite la configuración del proxy.
SupportsRedirectConfiguration	Obtiene un valor que indica si el controlador admite valores de configuración para las AllowAutoRedirect propiedades y MaxAutomaticRedirections .
UseCookies	Obtiene o establece un valor que indica si el controlador usa la CookieContainer propiedad para almacenar cookies de servidor y utiliza estas cookies al enviar solicitudes.
UseDefaultCredentials	Obtiene o establece un valor que controla si el controlador envía las credenciales predeterminadas con solicitudes.
UseProxy	Obtiene o establece un valor que indica si el controlador usa un proxy para las solicitudes.

Métodos

Nombre	Description
Dispose()	Libera los recursos no administrados y elimina los recursos administrados usados por .HttpMessageHandler (Heredado de HttpMessageHandler)
Dispose(Boolean)	Libera los recursos no administrados utilizados por HttpClientHandler y, opcionalmente, elimina los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Send(HttpRequestMessage, CancellationToken)	Crea una instancia de HttpResponseMessage basada en 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

• Conexión a un servicio web
• Inicio rápido: Conexión mediante HttpClient
• Uso de controladores HttpClient
• Protección de conexiones HttpClient