HttpClient Construtores

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Inicializa uma nova instância da classe HttpClient.

Sobrecargas

HttpClient()	Inicializa uma nova instância da classe HttpClient usando um HttpClientHandler que é descartado quando essa instância é descartada.
HttpClient(HttpMessageHandler)	Inicializa uma nova instância da classe HttpClient com o manipulador especificado. O manipulador é descartado quando essa instância é descartada.
HttpClient(HttpMessageHandler, Boolean)	Inicializa uma nova instância da classe HttpClient com o manipulador fornecido e especifica se esse manipulador deverá ser descartado quando essa instância for descartada.

Comentários

HttpClient destina-se a ser instanciado uma vez e reutilização ao longo da vida útil de um aplicativo. Criar uma instância de uma classe HttpClient para cada solicitação esgotará o número de soquetes disponíveis em cargas pesadas. Isso resultará em erros socketException. Veja abaixo um exemplo usando HttpClient corretamente.

C#

public class GoodController : ApiController
{
    private static readonly HttpClient HttpClient;

    static GoodController()
    {
        HttpClient = new HttpClient();
    }
}

HttpClient()

Origem:

HttpClient.cs

Inicializa uma nova instância da classe HttpClient usando um HttpClientHandler que é descartado quando essa instância é descartada.

C#

public HttpClient ();

Comentários

Usar esse construtor é equivalente a chamar o HttpClient(new HttpClientHandler(), true) construtor.

HttpClient(HttpMessageHandler)

Origem:

HttpClient.cs

Inicializa uma nova instância da classe HttpClient com o manipulador especificado. O manipulador é descartado quando essa instância é descartada.

C#

public HttpClient (System.Net.Http.HttpMessageHandler handler);

Parâmetros

handler

HttpMessageHandler

A pilha do manipulador HTTP a ser usada para enviar solicitações.

Exceções

ArgumentNullException

O handler é null.

Comentários

Usar esse construtor é equivalente a chamar o HttpClient(handler, true) construtor.

O especificado handler será descartado chamando HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean)

Origem:

HttpClient.cs

Inicializa uma nova instância da classe HttpClient com o manipulador fornecido e especifica se esse manipulador deverá ser descartado quando essa instância for descartada.

C#

public HttpClient (System.Net.Http.HttpMessageHandler handler, bool disposeHandler);

Parâmetros

handler

HttpMessageHandler

O HttpMessageHandler responsável por processar as mensagens de resposta HTTP.

disposeHandler

Boolean

true se o manipulador interno precisar ser descartado por HttpClient.Dispose, false se você quiser reutilizar o manipulador interno.

Exceções

ArgumentNullException

O handler é null.