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 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 ese controlador se debe eliminar cuando se elimina esta instancia.

Comentarios

HttpClient está pensado para crear instancias una vez y volver a usarse durante toda la vida útil 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 mediante 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 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 llamar al constructor de 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 del controlador HTTP que se va a usar para enviar solicitudes.

Excepciones

ArgumentNullException

El handler es null.

Comentarios

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

El handler especificado 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 ese controlador se debe eliminar cuando se elimina 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

El HttpMessageHandler responsable de procesar los mensajes de respuesta HTTP.

disposeHandler

Boolean

true si HttpClient.Dispose debe eliminar el controlador interno de ; false si piensa reutilizar el controlador interno.

Excepciones

ArgumentNullException

El handler es null.