HttpClient Constructores

Definición

Espacio de nombres:

System.Net.Http

Ensamblado:

System.Net.Http.dll

Inicializa una nueva instancia de la clase HttpClient.

Sobrecargas

HttpClient()	Inicializa una nueva instancia de la clase HttpClient mediante un controlador HttpClientHandler que se elimina cuando se elimina esta instancia.
HttpClient(HttpMessageHandler)	Inicializa una nueva instancia de la clase HttpClient con el controlador especificado. El controlador se elimina cuando se elimina esta instancia.
HttpClient(HttpMessageHandler, Boolean)	Inicializa una nueva instancia de la clase HttpClient con el controlador proporcionado y especifica si se debe eliminar ese controlador cuando se elimine esta instancia.

Comentarios

HttpClient está pensado para crear instancias una vez y volver a usarse durante toda la vida de una aplicación. La creación de instancias de una clase HttpClient para cada solicitud agotará el número de sockets disponibles en cargas pesadas. Esto provocará errores de SocketException. A continuación se muestra un ejemplo con HttpClient correctamente.

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

Source:

HttpClient.cs

Inicializa una nueva instancia de la clase HttpClient mediante un controlador HttpClientHandler que se elimina cuando se elimina esta instancia.

public:
 HttpClient();

public HttpClient ();

Public Sub New ()

Comentarios

El uso de este constructor es equivalente a la llamada al constructor HttpClient(new HttpClientHandler(), true).

HttpClient(HttpMessageHandler)

Source:

HttpClient.cs

Inicializa una nueva instancia de la clase HttpClient con el controlador especificado. El controlador se elimina cuando se elimina esta instancia.

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

Pila de controlador HTTP que se va a usar para enviar solicitudes.

Excepciones

ArgumentNullException

El valor de handler es null.

Comentarios

El uso de este constructor es equivalente a la llamada al constructor HttpClient(handler, true).

El especificado handler se eliminará llamando a HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean)

Source:

HttpClient.cs

Inicializa una nueva instancia de la clase HttpClient con el controlador proporcionado y especifica si se debe eliminar ese controlador cuando se elimine esta instancia.

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

HttpMessageHandler responsable de procesar los mensajes de respuesta HTTP.

disposeHandler

Boolean

true si HttpClient.Dispose debe desechar el controlador interno; false si piensa volver a usar el controlador interno.

Excepciones

ArgumentNullException

El valor de handler es null.