HttpClient Constructeurs

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.dll

Initialise une nouvelle instance de la classe HttpClient.

Surcharges

HttpClient()	Initialise une nouvelle instance de la classe HttpClient avec un HttpClientHandler qui est supprimé lorsque cette instance est supprimée.
HttpClient(HttpMessageHandler)	Initialise une nouvelle instance de la classe HttpClient avec le gestionnaire spécifié. Le gestionnaire est supprimé lorsque cette instance est supprimée.
HttpClient(HttpMessageHandler, Boolean)	Initialise une nouvelle instance de la classe HttpClient avec le gestionnaire fourni et spécifie si ce gestionnaire doit être supprimé quand cette instance est supprimée.

Remarques

HttpClient est destiné à être instancié une seule fois et réutilisé pendant toute la durée de vie d’une application. L’instanciation d’une classe HttpClient pour chaque requête épuise le nombre de sockets disponibles sous des charges lourdes. Cela entraîne des erreurs SocketException. Voici un exemple d’utilisation correcte de HttpClient.

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

Initialise une nouvelle instance de la classe HttpClient avec un HttpClientHandler qui est supprimé lorsque cette instance est supprimée.

public:
 HttpClient();

public HttpClient ();

Public Sub New ()

Remarques

L’utilisation de ce constructeur revient à appeler le HttpClient(new HttpClientHandler(), true) constructeur.

HttpClient(HttpMessageHandler)

Source:

HttpClient.cs

Initialise une nouvelle instance de la classe HttpClient avec le gestionnaire spécifié. Le gestionnaire est supprimé lorsque cette instance est supprimée.

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)

Paramètres

handler

HttpMessageHandler

Pile du gestionnaire HTTP à utiliser pour envoyer des demandes.

Exceptions

ArgumentNullException

Le handler est null.

Remarques

L’utilisation de ce constructeur revient à appeler le HttpClient(handler, true) constructeur.

Le spécifié handler sera supprimé en appelant HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean)

Source:

HttpClient.cs

Initialise une nouvelle instance de la classe HttpClient avec le gestionnaire fourni et spécifie si ce gestionnaire doit être supprimé quand cette instance est supprimée.

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)

Paramètres

handler

HttpMessageHandler

HttpMessageHandler chargé de traiter les messages de réponse HTTP.

disposeHandler

Boolean

true si le gestionnaire interne doit être supprimé à l’aide de HttpClient.Dispose ; false si vous prévoyez de réutiliser le gestionnaire interne.

Exceptions

ArgumentNullException

handler a la valeur null.