HttpClient Classe

Définition

Espace de noms:

System.Net.Http

Assemblys:

netstandard.dll, System.Net.Http.dll

Source:

HttpClient.cs

Fournit une classe pour l’envoi de requêtes HTTP et la réception de réponses HTTP à partir d’une ressource identifiée par un URI.

public ref class HttpClient : System::Net::Http::HttpMessageInvoker

public class HttpClient : System.Net.Http.HttpMessageInvoker

type HttpClient = class
    inherit HttpMessageInvoker

Public Class HttpClient
Inherits HttpMessageInvoker

Héritage

Object

HttpMessageInvoker

HttpClient

Exemples

// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
static readonly HttpClient client = new HttpClient();

static async Task Main()
{
    // Call asynchronous network methods in a try/catch block to handle exceptions.
    try
    {
        using HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
        response.EnsureSuccessStatusCode();
        string responseBody = await response.Content.ReadAsStringAsync();
        // Above three lines can be replaced with new helper method below
        // string responseBody = await client.GetStringAsync(uri);

        Console.WriteLine(responseBody);
    }
    catch (HttpRequestException e)
    {
        Console.WriteLine("\nException Caught!");
        Console.WriteLine("Message :{0} ", e.Message);
    }
}

open System.Net.Http

// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
let client = new HttpClient()

let main =
    task {
        // Call asynchronous network methods in a try/catch block to handle exceptions.
        try
            use! response = client.GetAsync "http://www.contoso.com/"
            response.EnsureSuccessStatusCode() |> ignore
            let! responseBody = response.Content.ReadAsStringAsync()
            // Above three lines can be replaced with new helper method below
            // let! responseBody = client.GetStringAsync uri

            printfn $"{responseBody}"
        with
        | :? HttpRequestException as e ->
            printfn "\nException Caught!"
            printfn $"Message :{e.Message} "
    }

main.Wait()

' HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
Shared ReadOnly client As HttpClient = New HttpClient()

Private Shared Async Function Main() As Task
    ' Call asynchronous network methods in a try/catch block to handle exceptions.
    Try
        Using response As HttpResponseMessage = Await client.GetAsync("http://www.contoso.com/")
            response.EnsureSuccessStatusCode()
            Dim responseBody As String = Await response.Content.ReadAsStringAsync()
            ' Above three lines can be replaced with new helper method below
            ' Dim responseBody As String = Await client.GetStringAsync(uri)

            Console.WriteLine(responseBody)
        End Using
    Catch e As HttpRequestException
        Console.WriteLine(Environment.NewLine & "Exception Caught!")
        Console.WriteLine("Message :{0} ", e.Message)
    End Try
End Function

Remarques

Pour plus d’informations sur cette API, consultez les remarques d’API supplémentaires pour HttpClient.

Constructeurs

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, 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.
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.

Propriétés

Nom	Description
BaseAddress	Obtient ou définit l’adresse de base de l’URI (Uniform Resource Identifier) de la ressource Internet utilisée lors de l’envoi de requêtes.
DefaultProxy	Obtient ou définit le proxy HTTP global.
DefaultRequestHeaders	Obtient les en-têtes qui doivent être envoyés avec chaque requête.
DefaultRequestVersion	Obtient ou définit la version HTTP par défaut utilisée sur les requêtes suivantes effectuées par cette HttpClient instance.
DefaultVersionPolicy	Obtient ou définit la stratégie de version par défaut pour les demandes créées implicitement dans les méthodes pratiques, par exemple GetAsync(String) et PostAsync(String, HttpContent).
MaxResponseContentBufferSize	Obtient ou définit le nombre maximal d’octets à mettre en mémoire tampon lors de la lecture du contenu de la réponse.
Timeout	Obtient ou définit l’intervalle de temps à attendre avant l’expiration de la requête.

Méthodes

Nom	Description
CancelPendingRequests()	Annulez toutes les demandes en attente sur cette instance.
DeleteAsync(String, CancellationToken)	Envoyez une requête DELETE à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
DeleteAsync(String)	Envoyez une requête DELETE à l’URI spécifié en tant qu’opération asynchrone.
DeleteAsync(Uri, CancellationToken)	Envoyez une requête DELETE à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
DeleteAsync(Uri)	Envoyez une requête DELETE à l’URI spécifié en tant qu’opération asynchrone.
Dispose()	Libère les ressources non managées et supprime les ressources managées utilisées par le HttpMessageInvoker. (Hérité de HttpMessageInvoker)
Dispose(Boolean)	Libère les ressources non managées utilisées par les HttpClient ressources gérées et supprime éventuellement les ressources gérées.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetAsync(String, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
GetAsync(String, HttpCompletionOption, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP et un jeton d’annulation en tant qu’opération asynchrone.
GetAsync(String, HttpCompletionOption)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP en tant qu’opération asynchrone.
GetAsync(String)	Envoyez une requête GET à l’URI spécifié en tant qu’opération asynchrone.
GetAsync(Uri, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP et un jeton d’annulation en tant qu’opération asynchrone.
GetAsync(Uri, HttpCompletionOption)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP en tant qu’opération asynchrone.
GetAsync(Uri)	Envoyez une requête GET à l’URI spécifié en tant qu’opération asynchrone.
GetByteArrayAsync(String, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.
GetByteArrayAsync(String)	Envoie une requête GET à l’URI spécifié et retourne le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.
GetByteArrayAsync(Uri, CancellationToken)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.
GetByteArrayAsync(Uri)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetStreamAsync(String, CancellationToken)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse en tant que flux dans une opération asynchrone.
GetStreamAsync(String)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse en tant que flux dans une opération asynchrone.
GetStreamAsync(Uri, CancellationToken)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse en tant que flux dans une opération asynchrone.
GetStreamAsync(Uri)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse en tant que flux dans une opération asynchrone.
GetStringAsync(String, CancellationToken)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse sous forme de chaîne dans une opération asynchrone.
GetStringAsync(String)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse sous forme de chaîne dans une opération asynchrone.
GetStringAsync(Uri, CancellationToken)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse sous forme de chaîne dans une opération asynchrone.
GetStringAsync(Uri)	Envoyez une requête GET à l’URI spécifié et retournez le corps de la réponse sous forme de chaîne dans une opération asynchrone.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
PatchAsync(String, HttpContent, CancellationToken)	Envoie une requête PATCH avec un jeton d’annulation à un URI représenté sous forme de chaîne en tant qu’opération asynchrone.
PatchAsync(String, HttpContent)	Envoie une requête PATCH à un URI désigné sous la forme d’une chaîne en tant qu’opération asynchrone.
PatchAsync(Uri, HttpContent, CancellationToken)	Envoie une requête PATCH avec un jeton d’annulation en tant qu’opération asynchrone.
PatchAsync(Uri, HttpContent)	Envoie une requête PATCH en tant qu’opération asynchrone.
PostAsync(String, HttpContent, CancellationToken)	Envoyez une requête POST avec un jeton d’annulation en tant qu’opération asynchrone.
PostAsync(String, HttpContent)	Envoyez une requête POST à l’URI spécifié en tant qu’opération asynchrone.
PostAsync(Uri, HttpContent, CancellationToken)	Envoyez une requête POST avec un jeton d’annulation en tant qu’opération asynchrone.
PostAsync(Uri, HttpContent)	Envoyez une requête POST à l’URI spécifié en tant qu’opération asynchrone.
PutAsync(String, HttpContent, CancellationToken)	Envoyez une requête PUT avec un jeton d’annulation en tant qu’opération asynchrone.
PutAsync(String, HttpContent)	Envoyez une requête PUT à l’URI spécifié en tant qu’opération asynchrone.
PutAsync(Uri, HttpContent, CancellationToken)	Envoyez une requête PUT avec un jeton d’annulation en tant qu’opération asynchrone.
PutAsync(Uri, HttpContent)	Envoyez une requête PUT à l’URI spécifié en tant qu’opération asynchrone.
Send(HttpRequestMessage, CancellationToken)	Envoie une requête HTTP avec le jeton de requête et d’annulation spécifiés.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Envoie une requête HTTP avec la requête, l’option d’achèvement et le jeton d’annulation spécifiés.
Send(HttpRequestMessage, HttpCompletionOption)	Envoie une requête HTTP.
Send(HttpRequestMessage)	Envoie une requête HTTP avec la requête spécifiée.
SendAsync(HttpRequestMessage, CancellationToken)	Envoyez une requête HTTP en tant qu’opération asynchrone.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Envoyez une requête HTTP en tant qu’opération asynchrone.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Envoyez une requête HTTP en tant qu’opération asynchrone.
SendAsync(HttpRequestMessage)	Envoyez une requête HTTP en tant qu’opération asynchrone.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Méthodes d’extension

Nom	Description
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)	Envoie une HTTP GETrequête à l’élément spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération énumérable asynchrone.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Envoie une HTTP GET requête à l’élément spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération énumérable asynchrone.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Envoie une HTTP GETrequête à l’élément spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération énumérable asynchrone.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)	Envoie une HTTP GETrequête à l’élément spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération énumérable asynchrone.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Envoie une HTTP GETrequête à l’élément spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération énumérable asynchrone.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Envoie une HTTP GETrequête à l’élément spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération énumérable asynchrone.
GetFromJsonAsync(HttpClient, String, Type, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse en tant que JSON dans une opération asynchrone.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Envoie une requête PATCH à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Envoie une requête PATCH à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête PATCH à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Envoie une requête PATCH à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Envoie une requête PATCH à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête PATCH à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Envoie une requête POST à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Envoie une requête POST à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête POST à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Envoie une requête POST à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Envoie une requête POST à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Envoie une requête POST à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Envoyez une requête PUT à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Envoyez une requête PUT à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Envoyez une requête PUT à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Envoyez une requête PUT à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Envoyez une requête PUT à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Envoyez une requête PUT à l’URI spécifié contenant le value json sérialisé dans le corps de la requête.

Voir aussi

• Instructions d’utilisation de HttpClient
• Exemple HttpClient