HttpClient Constructeurs

Définition

Espace de noms:
System.Net.Http
Assembly:
System.Net.Http.dll
Assembly:
netstandard.dll

Initialise une nouvelle instance de la classe HttpClient.

Surcharges

Nom Description
HttpClient()

Initialise une nouvelle instance de la classe à l’aide HttpClient d’une HttpClientHandler instance supprimée lorsque cette instance est supprimée.
HttpClient(HttpMessageHandler)

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

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

Remarques

HttpClient est destiné à être instancié une fois et réutilisé tout au long de la durée d’une application. L’instanciation d’une classe HttpClient pour chaque requête épuise le nombre de sockets disponibles sous de lourdes charges. Cela entraîne des erreurs SocketException. Voici un exemple utilisant correctement 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()

Initialise une nouvelle instance de la classe à l’aide HttpClient d’une HttpClientHandler instance supprimée lorsque cette instance est supprimée.

public:
 HttpClient();
public HttpClient();
Public Sub New ()

Remarques

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

S’applique à

HttpClient(HttpMessageHandler)

Initialise une nouvelle instance de la HttpClient classe 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 de gestionnaires HTTP à utiliser pour l’envoi de requêtes.

Exceptions

ArgumentNullException

handler a la valeur null.

Remarques

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

Le paramètre spécifié handler est supprimé en appelant HttpClient.Dispose.

S’applique à

HttpClient(HttpMessageHandler, Boolean)

Initialise une nouvelle instance de la HttpClient classe avec le gestionnaire fourni et spécifie si ce gestionnaire doit être supprimé lorsque 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

Responsable HttpMessageHandler du traitement des messages de réponse HTTP.

disposeHandler
Boolean

true si le gestionnaire interne doit être supprimé par HttpClient.Dispose ; false si vous envisagez de réutiliser le gestionnaire interne.

Exceptions

ArgumentNullException

handler a la valeur null.

S’applique à