HttpClient Construtores

Definição

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

Sobrecargas

HttpClient()

Inicializa uma nova instância da classe HttpClient usando um HttpClientHandler que é descartado quando essa instância é descartada.Initializes a new instance of the HttpClient class using a HttpClientHandler that is disposed when this instance is disposed.

HttpClient(HttpMessageHandler)

Inicializa uma nova instância da classe HttpClient com o manipulador especificado.Initializes a new instance of the HttpClient class with the specified handler. O manipulador é descartado quando essa instância é descartada.The handler is disposed when this instance is disposed.

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.Initializes a new instance of the HttpClient class with the provided handler, and specifies whether that handler should be disposed when this instance is disposed.

Comentários

a HttpClient deve ser instanciada uma vez e reutilizada durante toda a vida útil de um aplicativo.HttpClient is intended to be instantiated once and re-used throughout the life of an application. A instanciação de uma classe HttpClient para cada solicitação irá esgotar o número de soquetes disponíveis sob cargas pesadas.Instantiating an HttpClient class for every request will exhaust the number of sockets available under heavy loads. Isso resultará em erros SocketException.This will result in SocketException errors. Veja abaixo um exemplo que usa HttpClient corretamente.Below is an example using HttpClient correctly.

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()

Inicializa uma nova instância da classe HttpClient usando um HttpClientHandler que é descartado quando essa instância é descartada.Initializes a new instance of the HttpClient class using a HttpClientHandler that is disposed when this instance is disposed.

public:
 HttpClient();
public HttpClient ();
Public Sub New ()

Comentários

O uso desse construtor é equivalente à chamada do construtor de HttpClient(new HttpClientHandler(), true) .Using this constructor is equivalent to calling the HttpClient(new HttpClientHandler(), true) constructor.

HttpClient(HttpMessageHandler)

Inicializa uma nova instância da classe HttpClient com o manipulador especificado.Initializes a new instance of the HttpClient class with the specified handler. O manipulador é descartado quando essa instância é descartada.The handler is disposed when this instance is disposed.

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.The HTTP handler stack to use for sending requests.

Exceções

O handler é null.The handler is null.

Comentários

O uso desse construtor é equivalente à chamada do construtor de HttpClient(handler, true) .Using this constructor is equivalent to calling the HttpClient(handler, true) constructor.

O handler especificado será descartado chamando HttpClient. Dispose.The specified handler will be disposed of by calling HttpClient.Dispose.

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.Initializes a new instance of the HttpClient class with the provided handler, and specifies whether that handler should be disposed when this instance is disposed.

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.The HttpMessageHandler responsible for processing the HTTP response messages.

disposeHandler
Boolean

true se o manipulador interno precisar ser descartado por HttpClient.Dispose, false se você quiser reutilizar o manipulador interno.true if the inner handler should be disposed of by HttpClient.Dispose; false if you intend to reuse the inner handler.

Exceções

O handler é null.The handler is null.

Aplica-se a