WinHttpHandler WinHttpHandler WinHttpHandler WinHttpHandler Class

Definição

WinHttpHandler é um manipulador de mensagens especiais baseado na interface do WinHTTP do Windows e destina-se ao uso em ambientes de servidor.WinHttpHandler is a specialty message handler based on the WinHTTP interface of Windows and is intended for use in server environments. Essa classe também está disponível para uso em aplicativos da Área de Trabalho instalando-os como um pacote do NuGet.This class is also available for use in Desktop apps by installing it as a NuGet package. Para obter mais informações sobre como instalar essa classe para uso em aplicativos de Área de Trabalho, consulte System.Net.Http.WinHttpHandler.For more information about installing this class for use in Desktop apps, see System.Net.Http.WinHttpHandler.

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

Comentários

WinHttpHandler é semelhante a outras classes existentes, como HttpClientHandler.WinHttpHandler is similar to other existing classes such as HttpClientHandler. WinHttpHandler Fornece um manipulador sob um HttpClient da instância e é usado para enviar solicitações HTTP para um servidor e receber respostas do servidor.WinHttpHandler provides a handler underneath an HttpClient instance and is used to send HTTP requests out to a server and receive server responses.

WinHttpHandler foi projetado para ser usado principalmente em ambientes de servidor pelo ASP.NET Core e outros aplicativos .NET que se comunicam com servidores HTTP.WinHttpHandler is designed to be used primarily in server environments by ASP.NET Core and other .NET applications that communicate with HTTP servers. WinHttpHandler também fornece aos desenvolvedores controle mais granular sobre comunicação de HTTP do aplicativo que o HttpClientHandler classe.WinHttpHandler also provides developers with more granular control over the application's HTTP communication than the HttpClientHandler class. Isso permite que os desenvolvedores a implementar cenários mais avançados de HTTP ou modificar os padrões do sistema (por exemplo, configurações de proxy, tempos limite e a validação do certificado SSL do servidor).This allows developers to implement more advanced HTTP scenarios or modify system defaults (for example, proxy settings, timeouts and server SSL certificate validation).

WinHttpHandler não se destina a ser uma substituição para HttpClientHandler, é uma versão mais avançada fornecida para cenários onde HttpClientHandler é insuficiente para desenvolvedores.WinHttpHandler is not intended to be a replacement for HttpClientHandler, it is a more advanced version provided for scenarios where HttpClientHandler is insufficient for developers. WinHttpHandler é implementado como um wrapper fino na interface do WinHTTP do Windows e tem suporte apenas em sistemas Windows.WinHttpHandler is implemented as a thin wrapper on the WinHTTP interface of Windows and is only supported on Windows systems.

Ao usar uma cadeia de vários manipuladores, WinHttpHandler deve estar na parte inferior da cadeia.When using a chain of multiple handlers, WinHttpHandler should be at the bottom of the chain.

Construtores

WinHttpHandler() WinHttpHandler() WinHttpHandler() WinHttpHandler()

Inicializa uma nova instância da classe WinHttpHandler.Initializes a new instance of the WinHttpHandler class.

Propriedades

AutomaticDecompression AutomaticDecompression AutomaticDecompression 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.Gets or sets the type of decompression method used by the handler for automatic decompression of the HTTP content response.

AutomaticRedirection AutomaticRedirection AutomaticRedirection AutomaticRedirection

Obtém ou define um valor que indica se o manipulador deve seguir respostas de redirecionamento de HTTP.Gets or sets a value that indicates whether the handler should follow HTTP redirection responses.

CheckCertificateRevocationList CheckCertificateRevocationList CheckCertificateRevocationList 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.Gets or sets a value that indicates whether to check the revocation list of certificates during SSL certificate validation.

ClientCertificateOption ClientCertificateOption ClientCertificateOption 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.Gets or sets a value that indicates if the certificate is automatically picked from the certificate store or if the caller is allowed to pass in a specific client certificate.

ClientCertificates ClientCertificates ClientCertificates ClientCertificates

Obtém ou define uma coleção de certificados do SSL de autenticação de cliente que são usados para autenticação de cliente pelo Manipulador de se a propriedade ClientCertificateOption estiver definida como Manual.Gets or sets a collection of client authentication SSL certificates that are used for client authentication by the Handler if the ClientCertificateOption property is set to Manual.

CookieContainer CookieContainer CookieContainer CookieContainer

Obtém ou define o objeto de contêiner do cookie gerenciado.Gets or sets the managed cookie container object. Esta propriedade é usada apenas quando a propriedade CookieUsePolicy está definida como UseSpecifiedCookieContainer.This property is only used when the CookieUsePolicy property is set to UseSpecifiedCookieContainer. Caso contrário, o método SendAsync(HttpRequestMessage, CancellationToken) gerará uma exceção.Otherwise, the SendAsync(HttpRequestMessage, CancellationToken) method will throw an exception.

CookieUsePolicy CookieUsePolicy CookieUsePolicy CookieUsePolicy

Obtém ou define um valor que indica como os cookies devem ser gerenciados e usados.Gets or sets a value that indicates how cookies should be managed and used. Os desenvolvedores podem optar por ignorar cookies, permitir que o manipulador gerencie-os automaticamente ou manipulá-los manualmente usando um objeto CookieContainer.Developers can choose to ignore cookies, allow the handler to automatically manage them or manually handle them using a CookieContainer object.

DefaultProxyCredentials DefaultProxyCredentials DefaultProxyCredentials DefaultProxyCredentials

Obtém ou define as credenciais usadas para autenticar o usuário em um proxy de autenticação.Gets or sets the credentials used to authenticate the user to an authenticating proxy.

MaxAutomaticRedirections MaxAutomaticRedirections MaxAutomaticRedirections MaxAutomaticRedirections

Obtém ou define o número máximo de redirecionamentos de HTTP permitidos.Gets or sets the maximum number of allowed HTTP redirects.

MaxConnectionsPerServer MaxConnectionsPerServer MaxConnectionsPerServer MaxConnectionsPerServer

Obtém ou define o número máximo de conexões TCP permitido para um único servidor.Gets or sets the maximum number of TCP connections allowed to a single server.

MaxResponseDrainSize MaxResponseDrainSize MaxResponseDrainSize MaxResponseDrainSize

Obtém ou define o volume máximo de dados que pode ser extraído das respostas em bytes.Gets or sets the maximum amount of data that can be drained from responses in bytes.

MaxResponseHeadersLength MaxResponseHeadersLength MaxResponseHeadersLength MaxResponseHeadersLength

Obtém ou define o tamanho máximo de parte do cabeçalho de resposta do servidor, em bytes.Gets or sets the maximum size of the header portion from the server response in bytes.

PreAuthenticate PreAuthenticate PreAuthenticate PreAuthenticate

Obtém ou define um valor que indica se o manipulador envia um cabeçalho de autorização com a solicitação.Gets or sets a value that indicates whether the handler sends an Authorization header with the request.

Properties Properties Properties Properties
Proxy Proxy Proxy Proxy

Obtém ou define o proxy personalizado quando a propriedade WindowsProxyUsePolicy é definida para usar um proxy personalizado.Gets or sets the custom proxy when the WindowsProxyUsePolicy property is set to use a custom proxy.

ReceiveDataTimeout ReceiveDataTimeout ReceiveDataTimeout ReceiveDataTimeout

Obtém ou define o tempo limite de recebimento da parte de dados de uma resposta do servidor.Gets or sets the timeout for receiving the data portion of a response from the server.

ReceiveHeadersTimeout ReceiveHeadersTimeout ReceiveHeadersTimeout ReceiveHeadersTimeout

Obtém ou define o tempo limite de recebimento dos cabeçalhos de uma resposta do servidor.Gets or sets the timeout for receiving the headers of a response from the server.

SendTimeout SendTimeout SendTimeout SendTimeout

Obtém ou define o tempo limite para enviar uma solicitação.Gets or sets the timeout for sending a request.

ServerCertificateValidationCallback ServerCertificateValidationCallback ServerCertificateValidationCallback ServerCertificateValidationCallback

Obtém ou define um método de retorno de chamada para validar o certificado do servidor.Gets or sets a callback method to validate the server certificate. Esse retorno de chamada faz parte do handshake SSL.This callback is part of the SSL handshake.

ServerCredentials ServerCredentials ServerCredentials ServerCredentials

Obtém ou define as credenciais a serem usadas pelo cliente para autenticar o servidor.Gets or sets the credentials to be used by the client to authenticate to the server.

SslProtocols SslProtocols SslProtocols SslProtocols

Obtém ou define a coleção dos protocolos TLS/SSL com suporte no cliente.Gets or sets the collection of TLS/SSL protocols supported by the client.

WindowsProxyUsePolicy WindowsProxyUsePolicy WindowsProxyUsePolicy WindowsProxyUsePolicy

Obtém ou define a configuração do proxy.Gets or sets the proxy setting. 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.This property can be set to disable the proxy, use a custom proxy, or use the proxy settings of WinHTTP or WinInet on the machine.

Métodos

Dispose() Dispose() Dispose() Dispose()

Libera os recursos não gerenciados e descarta aqueles gerenciados usados pelo HttpMessageHandler.Releases the unmanaged resources and disposes of the managed resources used by the HttpMessageHandler.

(Inherited from HttpMessageHandler)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken)

Envia uma solicitação HTTP como uma operação assíncrona.Sends an HTTP request as an asynchronous operation.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Aplica-se a