HttpBaseProtocolFilter Classe

Definição

Namespace:

Windows.Web.Http.Filters

O filtro de protocolo base para uma instância 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

Herança

Object Platform::Object IInspectable HttpBaseProtocolFilter

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable IHttpFilter

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A classe HttpBaseProtocolFilter fornece o filtro base ou manipulador usado por uma instância httpClient . Se nenhum filtro adicional for adicionado à instância httpClient , o objeto HttpBaseProtocolFilter será o único filtro.

A classe HttpBaseProtocolFilter fornece um conjunto de propriedades para alternar vários comportamentos de pilha HTTP de baixo nível.

Filtros adicionais com base na interface IHttpFilter podem ser adicionados à cadeia de filtros aplicada a uma instância httpClient que pode manipular ou processar ainda mais os resultados do objeto HttpBaseProtocolFilter.

O objeto HttpBaseProtocolFilter gera exceções ao enviar solicitações HTTP ou receber falhas de resposta e rede (perda de conectividade no modo avião, por exemplo). Os desenvolvedores que usam HttpClient em aplicativos podem preferir adicionar um filtro para capturar essas exceções e convertê-las em códigos de resposta HTTP.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1511	10586	CookieUsageBehavior
1607	14393	ClearAuthenticationCache
1607	14393	ServerCustomValidationRequested
1903	18362	CreateForUser
1903	18362	Usuário

Construtores

HttpBaseProtocolFilter()

Inicializa uma nova instância da classe HttpBaseProtocolFilter . Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

Propriedades

AllowAutoRedirect	Obtenha ou defina um valor que indica se o HttpBaseProtocolFilter deve seguir as respostas de redirecionamento.
AllowUI	Obtenha ou defina um valor que indica se o HttpBaseProtocolFilter pode solicitar credenciais de usuário quando solicitado pelo servidor.
AutomaticDecompression	Obtém ou define um valor que indica se o HttpBaseProtocolFilter pode descompactar automaticamente a resposta de conteúdo HTTP.
CacheControl	Obtenha ou defina o comportamento de controle de cache de leitura e gravação a ser usado no objeto HttpBaseProtocolFilter .
ClientCertificate	Obtenha ou defina o certificado SSL do cliente que será enviado ao servidor se o servidor solicitar um certificado do cliente.
CookieManager	Obtenha o HttpCookieManager com os cookies associados a um aplicativo.
CookieUsageBehavior	Obtém ou define o comportamento de uso do cookie. Por padrão, os cookies são manipulados automaticamente.
IgnorableServerCertificateErrors	Obtenha um vetor de erros de certificado do servidor SSL que o aplicativo pode optar por ignorar posteriormente.
MaxConnectionsPerServer	Obtenha ou defina o número máximo de conexões TCP permitidas por servidor HTTP pelo objeto HttpBaseProtocolFilter .
MaxVersion	Obtém ou define a versão do protocolo HTTP usado.
ProxyCredential	Obtenha ou defina as credenciais a serem usadas para negociar com um proxy HTTP.
ServerCredential	Obtenha ou defina as credenciais a serem usadas para autenticar com um servidor HTTP.
UseProxy	Obtenha ou defina um valor que indica se o HttpBaseProtocolFilter pode usar um proxy para enviar solicitações HTTP.
User	Obtém o Usuário associado ao HttpBaseProtocolFilter.

Métodos

ClearAuthenticationCache()	Limpa as credenciais de autenticação atualmente armazenadas em cache no dispositivo.
Close()	Fecha a instância httpBaseProtocolFilter e libera recursos alocados.
CreateForUser(User)	Cria um novo HttpBaseProtocolFilter para um usuário específico.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
SendRequestAsync(HttpRequestMessage)	Envie uma solicitação HTTP usando HttpBaseProtocolFilter como uma operação assíncrona.

Eventos

ServerCustomValidationRequested

Esse evento é gerado quando a conexão SSL/TLS está sendo estabelecida com o servidor. Você deverá implementar um manipulador de eventos para esse evento se precisar executar uma validação extra (além do padrão do sistema operacional) do certificado SSL do servidor.

Confira também

• IClosable
• IHttpFilter