Compartir a través de


HttpBaseProtocolFilter Clase

Definición

Filtro de protocolo base para una instancia httpClient .

public ref class HttpBaseProtocolFilter sealed : IClosable
public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HttpBaseProtocolFilter final : IClosable
/// [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
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HttpBaseProtocolFilter : System.IDisposable
[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
[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
Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable, IHttpFilter
Herencia
Object Platform::Object IInspectable HttpBaseProtocolFilter
Atributos
Implementaciones

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.

Se aplica a

Consulte también