Partilhar via


HttpClient Construtores

Definição

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
Origem:
HttpClient.cs
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.

Aplica-se a

HttpClient(HttpMessageHandler)

Origem:
HttpClient.cs
Origem:
HttpClient.cs
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

O handler é null.

Comentários

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

O especificado handler será descartado chamando HttpClient.Dispose.

Aplica-se a

HttpClient(HttpMessageHandler, Boolean)

Origem:
HttpClient.cs
Origem:
HttpClient.cs
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

O handler é null.

Aplica-se a