HttpBaseProtocolFilter Clase

Definición

Espacio de nombres:

Windows.Web.Http.Filters

Filtro de protocolo base para una instancia httpClient .

public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpBaseProtocolFilter final : IClosable, IHttpFilter

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpBaseProtocolFilter : System.IDisposable, IHttpFilter

function HttpBaseProtocolFilter()

Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable, IHttpFilter

Herencia

Object Platform::Object IInspectable HttpBaseProtocolFilter

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable IHttpFilter

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La clase HttpBaseProtocolFilter proporciona el filtro o controlador base que usa una instancia httpClient . Si no se agregan filtros adicionales a la instancia de HttpClient , el objeto HttpBaseProtocolFilter será el único filtro.

La clase HttpBaseProtocolFilter proporciona un conjunto de propiedades para alternar varios comportamientos de pila HTTP de bajo nivel.

Se pueden agregar filtros adicionales basados en la interfaz IHttpFilter a la cadena de filtros aplicada a una instancia httpClient que pueda controlar o procesar aún más los resultados del objeto HttpBaseProtocolFilter.

El objeto HttpBaseProtocolFilter produce excepciones al enviar solicitudes HTTP o recibir respuestas y errores de red (pérdida de conectividad en modo avión, por ejemplo). Los desarrolladores que usan HttpClient en las aplicaciones pueden preferir agregar un filtro para detectar estas excepciones y convertirlos en códigos de respuesta HTTP en su lugar.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1511	10586	CookieUsageBehavior
1607	14393	ClearAuthenticationCache
1607	14393	ServerCustomValidationRequested
1903	18362	CreateForUser
1903	18362	Usuario

Constructores

HttpBaseProtocolFilter()

Inicializa una nueva instancia de la clase HttpBaseProtocolFilter . En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

Propiedades

AllowAutoRedirect	Obtiene o establece un valor que indica si HttpBaseProtocolFilter debe seguir las respuestas de redireccionamiento.
AllowUI	Obtiene o establece un valor que indica si HttpBaseProtocolFilter puede solicitar las credenciales de usuario cuando lo solicite el servidor.
AutomaticDecompression	Obtiene o establece un valor que indica si HttpBaseProtocolFilter puede descomprimir automáticamente la respuesta de contenido HTTP.
CacheControl	Obtiene o establece el comportamiento del control de caché de lectura y escritura que se va a usar en el objeto HttpBaseProtocolFilter .
ClientCertificate	Obtenga o establezca el certificado SSL de cliente que se enviará al servidor si el servidor solicita un certificado de cliente.
CookieManager	Obtenga httpCookieManager con las cookies asociadas a una aplicación.
CookieUsageBehavior	Obtiene o establece el comportamiento de uso de cookies. De forma predeterminada, las cookies se controlan automáticamente.
IgnorableServerCertificateErrors	Obtenga un vector de errores de certificado de servidor SSL que la aplicación podría optar por omitir posteriormente.
MaxConnectionsPerServer	Obtiene o establece el número máximo de conexiones TCP permitidas por servidor HTTP por el objeto HttpBaseProtocolFilter .
MaxVersion	Obtiene o establece la versión del protocolo HTTP usado.
ProxyCredential	Obtenga o establezca las credenciales que se usarán para negociar con un proxy HTTP.
ServerCredential	Obtenga o establezca las credenciales que se usarán para autenticarse con un servidor HTTP.
UseProxy	Obtiene o establece un valor que indica si HttpBaseProtocolFilter puede usar un proxy para enviar solicitudes HTTP.
User	Obtiene el usuario asociado a HttpBaseProtocolFilter.

Métodos

ClearAuthenticationCache()	Borra las credenciales de autenticación almacenadas actualmente en caché en el dispositivo.
Close()	Cierra la instancia de HttpBaseProtocolFilter y libera los recursos asignados.
CreateForUser(User)	Crea un nuevo HttpBaseProtocolFilter para un usuario específico.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
SendRequestAsync(HttpRequestMessage)	Envíe una solicitud HTTP mediante HttpBaseProtocolFilter como una operación asincrónica.

Eventos

ServerCustomValidationRequested

Este evento se genera cuando se establece la conexión SSL/TLS con el servidor. Debe implementar un controlador de eventos para este evento si necesita realizar una validación adicional (además del valor predeterminado del sistema operativo) del certificado SSL del servidor.

Consulte también

• IClosable
• IHttpFilter