Partage via


HttpClient Constructeurs

Définition

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
Source:
HttpClient.cs
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.

S’applique à

HttpClient(HttpMessageHandler)

Source:
HttpClient.cs
Source:
HttpClient.cs
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

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.

S’applique à

HttpClient(HttpMessageHandler, Boolean)

Source:
HttpClient.cs
Source:
HttpClient.cs
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

handler a la valeur null.

S’applique à