HttpClient Costruttori

Definizione

Spazio dei nomi:

System.Net.Http

Assembly:

System.Net.Http.dll

Inizializza una nuova istanza della classe HttpClient.

Overload

HttpClient()	Inizializza una nuova istanza della classe HttpClient con HttpClientHandler che viene eliminato quando viene eliminata l'istanza.
HttpClient(HttpMessageHandler)	Inizializza una nuova istanza della classe HttpClient con il gestore specificato. Il gestore viene eliminato quando viene eliminata l'istanza.
HttpClient(HttpMessageHandler, Boolean)	Inizializza una nuova istanza della classe HttpClient con il gestore specificato e stabilisce se il gestore deve essere eliminato quando viene eliminata l'istanza.

Commenti

HttpClient deve essere creata un'istanza una sola volta e usata nuovamente per tutta la durata di un'applicazione. La creazione di un'istanza di una classe HttpClient per ogni richiesta esaurisce il numero di socket disponibili con carichi elevati. Ciò comporterà errori SocketException. Di seguito è riportato un esempio che usa HttpClient correttamente.

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

Origine:

HttpClient.cs

Inizializza una nuova istanza della classe HttpClient con HttpClientHandler che viene eliminato quando viene eliminata l'istanza.

public:
 HttpClient();

public HttpClient ();

Public Sub New ()

Commenti

L'uso di questo costruttore equivale a chiamare il HttpClient(new HttpClientHandler(), true) costruttore.

HttpClient(HttpMessageHandler)

Origine:

HttpClient.cs

Inizializza una nuova istanza della classe HttpClient con il gestore specificato. Il gestore viene eliminato quando viene eliminata l'istanza.

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)

Parametri

handler

HttpMessageHandler

Stack del gestore HTTP da usare per inviare le richieste.

Eccezioni

ArgumentNullException

L'elemento handler è null.

Commenti

L'uso di questo costruttore equivale a chiamare il HttpClient(handler, true) costruttore.

L'oggetto specificato handler verrà eliminato chiamando HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean)

Origine:

HttpClient.cs

Inizializza una nuova istanza della classe HttpClient con il gestore specificato e stabilisce se il gestore deve essere eliminato quando viene eliminata l'istanza.

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)

Parametri

handler

HttpMessageHandler

Oggetto HttpMessageHandler responsabile dell'elaborazione dei messaggi di risposta HTTP.

disposeHandler

Boolean

true se il gestore interno deve essere eliminato da HttpClient.Dispose, false se si intende usare ancora il gestore interno.

Eccezioni

ArgumentNullException

L'elemento handler è null.