WinHttpHandler Classe

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.WinHttpHandler.dll

Pacote:

System.Net.Http.WinHttpHandler v8.0.0

Origem:

WinHttpHandler.cs

Manipula mensagens com base na interface WinHTTP do Windows. Essa classe destina-se ao uso em ambientes de servidor.

public ref class WinHttpHandler : System::Net::Http::HttpMessageHandler

public class WinHttpHandler : System.Net.Http.HttpMessageHandler

type WinHttpHandler = class
    inherit HttpMessageHandler

Public Class WinHttpHandler
Inherits HttpMessageHandler

Herança

Object

HttpMessageHandler

WinHttpHandler

Comentários

WinHttpHandler é semelhante a outras classes existentes, como HttpClientHandler. WinHttpHandler fornece um manipulador sob uma HttpClient instância e é usado para enviar solicitações HTTP para um servidor e receber respostas do servidor. A WinHttpHandler implementação dá suporte a versões HTTP até HTTP/2.

WinHttpHandlerfoi projetado para ser usado principalmente em ambientes de servidor por ASP.NET Core e outros aplicativos .NET que se comunicam com servidores HTTP. WinHttpHandler também fornece aos desenvolvedores um controle mais granular sobre a comunicação HTTP do aplicativo do que a HttpClientHandler classe . Isso permite que os desenvolvedores implementem cenários HTTP mais avançados ou modifiquem os padrões do sistema (por exemplo, configurações de proxy, tempos limite e validação de certificado SSL do servidor).

WinHttpHandler não se destina a ser uma substituição para HttpClientHandler. Em vez disso, é uma versão mais avançada fornecida para cenários em HttpClientHandler que não é suficiente. WinHttpHandler é implementado como um wrapper fino na interface WinHTTP do Windows e só tem suporte em sistemas Windows.

Ao usar uma cadeia de vários manipuladores, WinHttpHandler deve estar na parte inferior da cadeia.

Essa classe também está disponível para uso em aplicativos da Área de Trabalho instalando-os como um pacote do NuGet. Para obter mais informações, consulte Pacote NuGet System.Net.Http.WinHttpHandler.

A partir do .NET 5, WinHttpHandler não está mais incluído no assembly System.Net.Http.dll como parte do runtime do .NET. Para obter mais informações, consulte WinHttpHandler removido do runtime do .NET.

Construtores

WinHttpHandler()

Inicializa uma nova instância da classe WinHttpHandler.

Propriedades

AutomaticDecompression	Obtém ou define o tipo de método de descompactação usado pelo manipulador para descompactação automática da resposta de conteúdo HTTP.
AutomaticRedirection	Obtém ou define um valor que indica se o manipulador deve seguir respostas de redirecionamento de HTTP.
CheckCertificateRevocationList	Obtém ou define um valor que indica se é necessário verificar a lista de revogação de certificados durante a validação do certificado SSL.
ClientCertificateOption	Obtém ou define um valor que indica se o certificado é selecionado automaticamente do repositório de certificados ou se o chamador tem permissão para passar um certificado do cliente específico.
ClientCertificates	Obterá uma coleção de certificados SSL de autenticação de cliente que serão usados para autenticação de cliente pelo manipulador se a propriedade ClientCertificateOption for definida como Manual.
CookieContainer	Obtém ou define o objeto de contêiner do cookie gerenciado. Esta propriedade é usada apenas quando a propriedade CookieUsePolicy está definida como UseSpecifiedCookieContainer. Caso contrário, o método SendAsync(HttpRequestMessage, CancellationToken) gerará uma exceção.
CookieUsePolicy	Obtém ou define um valor que indica como os cookies devem ser gerenciados e usados. Os desenvolvedores podem optar por ignorar cookies, permitir que o manipulador gerencie-os automaticamente ou manipulá-los manualmente usando um objeto CookieContainer.
DefaultProxyCredentials	Obtém ou define as credenciais usadas para autenticar o usuário em um proxy de autenticação.
EnableMultipleHttp2Connections	Obtém ou define um valor que indica se conexões HTTP/2 adicionais podem ser estabelecidas para o mesmo servidor quando o número máximo de fluxos simultâneos é atingido em todas as conexões existentes.
MaxAutomaticRedirections	Obtém ou define o número máximo de redirecionamentos de HTTP permitidos.
MaxConnectionsPerServer	Obtém ou define o número máximo de conexões TCP permitido para um único servidor.
MaxResponseDrainSize	Obtém ou define o volume máximo de dados que pode ser extraído das respostas em bytes.
MaxResponseHeadersLength	Obtém ou define o tamanho máximo de parte do cabeçalho de resposta do servidor, em bytes.
PreAuthenticate	Obtém ou define um valor que indica se o manipulador envia um cabeçalho de autorização com a solicitação.
Properties	Obtém um dicionário gravável (ou seja, um mapa) de propriedades personalizadas para as solicitações de HttpClient. O dicionário é inicializado vazio. Você pode inserir e consultar pares chave-valor para seus manipuladores personalizados e processamento especial.
Proxy	Obtém ou define o proxy personalizado quando a propriedade WindowsProxyUsePolicy é definida para usar um proxy personalizado.
ReceiveDataTimeout	Obtém ou define o tempo limite de recebimento da parte de dados de uma resposta do servidor.
ReceiveHeadersTimeout	Obtém ou define o tempo limite de recebimento dos cabeçalhos de uma resposta do servidor.
SendTimeout	Obtém ou define o tempo limite para enviar uma solicitação.
ServerCertificateValidationCallback	Obtém ou define um método de retorno de chamada para validar o certificado do servidor. Esse retorno de chamada faz parte do handshake SSL.
ServerCredentials	Obtém ou define as credenciais a serem usadas pelo cliente para autenticar o servidor.
SslProtocols	Obtém ou define a coleção dos protocolos TLS/SSL com suporte no cliente.
TcpKeepAliveEnabled	Obtém ou define um valor que indica se o keep alive do TCP está habilitado.
TcpKeepAliveInterval	Obtém ou define o intervalo de keep alive do TCP.
TcpKeepAliveTime	Obtém ou define o tempo limite de keep alive do TCP.
WindowsProxyUsePolicy	Obtém ou define a configuração do proxy. Essa propriedade pode ser definida para desabilitar o proxy, usar um proxy personalizado ou usar as configurações de proxy do WinHTTP ou WinInet no computador.

Métodos

Dispose()	Libera os recursos não gerenciados e descarta aqueles gerenciados usados pelo HttpMessageHandler. (Herdado de HttpMessageHandler)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo WinHttpHandler e, opcionalmente, descarta os recursos gerenciados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Send(HttpRequestMessage, CancellationToken)	Quando substituído em uma classe derivada, envia uma solicitação HTTP com a solicitação e o token de cancelamento especificados. Caso contrário, gerará um NotSupportedException. (Herdado de HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)	Envia uma solicitação HTTP como uma operação assíncrona.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)