WinHttpHandler Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Controla los mensajes basados en la interfaz WinHTTP de Windows. Esta clase está pensada para usarse en entornos de servidor.
public ref class WinHttpHandler : System::Net::Http::HttpMessageHandlerpublic class WinHttpHandler : System.Net.Http.HttpMessageHandlertype WinHttpHandler = class
inherit HttpMessageHandlerPublic Class WinHttpHandler
Inherits HttpMessageHandler- Herencia
Comentarios
WinHttpHandler es similar a otras clases existentes, como HttpClientHandler. WinHttpHandler proporciona un controlador debajo de una HttpClient instancia y se usa para enviar solicitudes HTTP a un servidor y recibir respuestas del servidor. La WinHttpHandler implementación admite versiones HTTP de hasta HTTP/2.
WinHttpHandlerestá diseñado para usarse principalmente en entornos de servidor mediante ASP.NET Core y otras aplicaciones .NET que se comunican con servidores HTTP. WinHttpHandler también proporciona a los desarrolladores un control más pormenorizado sobre la comunicación HTTP de la aplicación que la HttpClientHandler clase . Esto permite a los desarrolladores implementar escenarios HTTP más avanzados o modificar los valores predeterminados del sistema (por ejemplo, configuración de proxy, tiempos de espera y validación de certificados SSL de servidor).
WinHttpHandler no pretende ser un reemplazo de HttpClientHandler. En su lugar, es una versión más avanzada que se proporciona para escenarios en HttpClientHandler los que no es suficiente. WinHttpHandler se implementa como un contenedor fino en la interfaz WinHTTP de Windows y solo se admite en sistemas Windows.
Al usar una cadena de varios controladores, WinHttpHandler debe estar en la parte inferior de la cadena.
Esta clase también está disponible para su uso en aplicaciones de escritorio mediante su instalación como un paquete NuGet. Para obtener más información, vea Paquete NuGet System.Net.Http.WinHttpHandler.
A partir de .NET 5, WinHttpHandler ya no se incluye en el ensamblado deSystem.Net.Http.dll como parte del entorno de ejecución de .NET. Para obtener más información, consulte WinHttpHandler quitado del entorno de ejecución de .NET.
Constructores
| WinHttpHandler() |
Inicializa una nueva instancia de la clase WinHttpHandler. |
Propiedades
| 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. |
| AutomaticRedirection |
Obtiene o establece un valor que indica si el controlador debe seguir las respuestas de redirección HTTP. |
| CheckCertificateRevocationList |
Obtiene o establece un valor que indica si se debe comprobar la lista de revocación de certificados durante la validación de certificados SSL. |
| ClientCertificateOption |
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 |
Permite obtener una colección de certificados SSL de autenticación de clientes que usa el controlador para la autenticación de clientes si la propiedad ClientCertificateOption está establecida en |
| CookieContainer |
Obtiene o establece el objeto contenedor de cookies administrado. Esta propiedad se usa únicamente cuando la propiedad CookieUsePolicy está establecida en UseSpecifiedCookieContainer. De lo contrario, el método SendAsync(HttpRequestMessage, CancellationToken) produce una excepción. |
| CookieUsePolicy |
Obtiene o establece un valor que indica cómo se deben administrar y usar las cookies. Los desarrolladores pueden optar por omitir las cookies, permitir que el controlador las administre de forma automática o controlarlas manualmente mediante un objeto CookieContainer. |
| DefaultProxyCredentials |
Obtiene o establece las credenciales usadas para autenticar al usuario en un proxy de autenticación. |
| EnableMultipleHttp2Connections |
Obtiene o establece un valor que indica si se pueden establecer conexiones HTTP/2 adicionales al mismo servidor cuando se alcanza el número máximo de flujos simultáneos en todas las conexiones siguientes. |
| MaxAutomaticRedirections |
Obtiene o establece el número máximo de redirecciones HTTP permitidas. |
| MaxConnectionsPerServer |
Obtiene o establece el número máximo de conexiones TCP permitidas en un único servidor. |
| MaxResponseDrainSize |
Obtiene o establece la cantidad máxima de datos que se pueden agotar de respuestas en bytes. |
| MaxResponseHeadersLength |
Obtiene o establece el tamaño máximo de la parte de encabezado de la respuesta del servidor en bytes. |
| 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 el proxy personalizado cuando la propiedad WindowsProxyUsePolicy está establecida para usar un proxy personalizado. |
| ReceiveDataTimeout |
Obtiene o establece el tiempo de espera para recibir la parte de datos de una respuesta del servidor. |
| ReceiveHeadersTimeout |
Obtiene o establece el tiempo de espera para recibir los encabezados de una respuesta del servidor. |
| SendTimeout |
Obtiene o establece el tiempo de espera para enviar una solicitud. |
| ServerCertificateValidationCallback |
Obtiene o establece un método de devolución de llamada para validar el certificado de servidor. Esta devolución de llamada es parte del protocolo de enlace SSL. |
| ServerCredentials |
Obtiene o establece las credenciales que va a usar el cliente para autenticarse en el servidor. |
| SslProtocols |
Obtiene o establece la colección de protocolos TLS/SSL admitidos por el cliente. |
| TcpKeepAliveEnabled |
Obtiene o establece un valor que indica si TCP keep-alive está habilitado. |
| TcpKeepAliveInterval |
Obtiene o establece el intervalo de mantenimiento de TCP. |
| TcpKeepAliveTime |
Obtiene o establece el tiempo de espera de mantenimiento de TCP. |
| WindowsProxyUsePolicy |
Obtiene o establece la configuración de proxy. Esta propiedad se puede establecer de modo que se deshabilite el proxy, se use un proxy personalizado o se emplee la configuración de proxy de WinHTTP o WinInet en el equipo. |
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 WinHttpHandler 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) |
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) |
Envía una solicitud HTTP como una operación asincrónica. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
