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.

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

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

  Public Class GoodController
    Inherits ApiController

    Private Shared ReadOnly HttpClient As HttpClient

    Shared Sub New()
        HttpClient = New HttpClient()
    End Sub
End Class

HttpClient()

Origem:

HttpClient.cs

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

public:
 HttpClient();

public HttpClient ();

Public Sub New ()

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.

public:
 HttpClient(System::Net::Http::HttpMessageHandler ^ handler);

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

new System.Net.Http.HttpClient : System.Net.Http.HttpMessageHandler -> System.Net.Http.HttpClient

Public Sub New (handler As HttpMessageHandler)

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.

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

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

new System.Net.Http.HttpClient : System.Net.Http.HttpMessageHandler * bool -> System.Net.Http.HttpClient

Public Sub New (handler As HttpMessageHandler, disposeHandler As Boolean)

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.