Partage via


HttpClient Classe

Définition

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

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 Remarques supplémentaires sur l’API pour HttpClient.

Constructeurs

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.

Propriétés

BaseAddress

Obtient ou définit l'adresse de base de l'URI de la ressource Internet utilisée pour envoyer des demandes.

DefaultProxy

Obtient ou définit le proxy HTTP global.

DefaultRequestHeaders

Obtient les en-têtes qui doivent être envoyés avec chaque demande.

DefaultRequestVersion

Obtient ou définit la version de HTTP par défaut utilisée pour les requêtes suivantes effectuées par cette instance de HttpClient.

DefaultVersionPolicy

Obtient ou définit la stratégie de version par défaut pour les requêtes 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 réponse.

Timeout

Obtient ou définit la période d'attente jusqu'à l'expiration de la demande.

Méthodes

CancelPendingRequests()

Annulez toutes les demandes en attente sur cette instance.

DeleteAsync(String)

Envoie une demande DELETE à l'URI spécifié sous forme d'opération asynchrone.

DeleteAsync(String, CancellationToken)

Envoie une requête DELETE à l'URI spécifié avec un jeton d'annulation sous forme d'opération asynchrone.

DeleteAsync(Uri)

Envoie une demande DELETE à l'URI spécifié sous forme d'opération asynchrone.

DeleteAsync(Uri, CancellationToken)

Envoie une requête DELETE à l'URI spécifié avec un jeton d'annulation sous forme d'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 le HttpClient et supprime éventuellement les ressources managées.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetAsync(String)

Envoie une requête GET vers l'URI spécifié sous forme d'opération asynchrone.

GetAsync(String, CancellationToken)

Envoie une requête GET à l'URI spécifié avec un jeton d'annulation sous forme d'opération asynchrone.

GetAsync(String, HttpCompletionOption)

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP sous forme d'opération asynchrone.

GetAsync(String, HttpCompletionOption, CancellationToken)

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP et un jeton d'annulation sous forme d'opération asynchrone.

GetAsync(Uri)

Envoie une requête GET vers l'URI spécifié sous forme d'opération asynchrone.

GetAsync(Uri, CancellationToken)

Envoie une requête GET à l'URI spécifié avec un jeton d'annulation sous forme d'opération asynchrone.

GetAsync(Uri, HttpCompletionOption)

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP sous forme d'opération asynchrone.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP et un jeton d'annulation sous forme d'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(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(Uri)

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)

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.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetStreamAsync(String)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de flux dans une opération asynchrone.

GetStreamAsync(String, CancellationToken)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de flux dans une opération asynchrone.

GetStreamAsync(Uri)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de flux dans une opération asynchrone.

GetStreamAsync(Uri, CancellationToken)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de flux dans une opération asynchrone.

GetStringAsync(String)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.

GetStringAsync(String, CancellationToken)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.

GetStringAsync(Uri)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.

GetStringAsync(Uri, CancellationToken)

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
PatchAsync(String, HttpContent)

Envoie une requête PATCH à un URI désigné comme chaîne en tant qu’opération asynchrone.

PatchAsync(String, HttpContent, CancellationToken)

Envoie une requête PATCH avec un jeton d’annulation à un URI représenté comme chaîne dans une opération asynchrone.

PatchAsync(Uri, HttpContent)

Envoie une requête PATCH en tant qu’opération asynchrone.

PatchAsync(Uri, HttpContent, CancellationToken)

Envoie une requête PATCH avec un jeton d'annulation sous forme d'opération asynchrone.

PostAsync(String, HttpContent)

Envoie une requête POST vers l'URI spécifié sous forme d'opération asynchrone.

PostAsync(String, HttpContent, CancellationToken)

Envoie une requête POST avec un jeton d'annulation sous forme d'opération asynchrone.

PostAsync(Uri, HttpContent)

Envoie une requête POST vers l'URI spécifié sous forme d'opération asynchrone.

PostAsync(Uri, HttpContent, CancellationToken)

Envoie une requête POST avec un jeton d'annulation sous forme d'opération asynchrone.

PutAsync(String, HttpContent)

Envoie une requête PUT vers l'URI spécifié sous forme d'opération asynchrone.

PutAsync(String, HttpContent, CancellationToken)

Envoyez une requête PUT avec un jeton d'annulation sous forme d'opération asynchrone.

PutAsync(Uri, HttpContent)

Envoie une requête PUT vers l'URI spécifié sous forme d'opération asynchrone.

PutAsync(Uri, HttpContent, CancellationToken)

Envoyez une requête PUT avec un jeton d'annulation sous forme d'opération asynchrone.

Send(HttpRequestMessage)

Envoie une requête HTTP avec la requête spécifiée.

Send(HttpRequestMessage, CancellationToken)

Envoie une requête HTTP avec le jeton de requête et d’annulation spécifiés.

Send(HttpRequestMessage, CancellationToken)

Envoie une requête HTTP avec le jeton de requête et d’annulation spécifiés.

(Hérité de HttpMessageInvoker)
Send(HttpRequestMessage, HttpCompletionOption)

Envoie une requête HTTP.

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.

SendAsync(HttpRequestMessage)

Envoie une requête HTTP en tant qu'opération asynchrone.

SendAsync(HttpRequestMessage, CancellationToken)

Envoie une requête HTTP en tant qu'opération asynchrone.

SendAsync(HttpRequestMessage, HttpCompletionOption)

Envoie une requête HTTP en tant qu'opération asynchrone.

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Envoie 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

DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)

Envoie une demande DELETE à l’URI spécifié et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération asynchrone.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)

Envoie une HTTP GET requête au spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération énumérable asynchrone.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)

Envoie une HTTP GETrequête au spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération énumérable asynchrone.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)

Envoie une HTTP GETrequête au spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération énumérable asynchrone.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)

Envoie une HTTP GETrequête au spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération énumérable asynchrone.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)

Envoie une HTTP GETrequête au spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération énumérable asynchrone.

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)

Envoie une HTTP GETrequête au spécifié requestUri et retourne la valeur qui résulte de la désérialisation du corps de la réponse au format JSON dans une opération énumérable 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 au format 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 au format JSON dans une opération 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 au format 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 au format 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 au format 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 au format 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 au format 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 au format 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 au format 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 au format 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 au format 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 au format JSON dans une opération asynchrone.

PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

Envoie une requête PATCH à l’URI spécifié contenant le value sérialisé au format JSON 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 sérialisé au format JSON dans le corps de la requête.

PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

Envoie une requête PATCH à l’URI spécifié contenant le value sérialisé au format JSON 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 sérialisé au format JSON 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 sérialisé au format JSON 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 sérialisé au format JSON dans le corps de la requête.

PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

Envoie une requête POST à l’URI spécifié contenant la value sérialisée au format JSON dans le corps de la demande.

PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

Envoie une requête POST à l’URI spécifié contenant la value sérialisée au format JSON dans le corps de la demande.

PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

Envoie une requête POST à l’URI spécifié contenant la value sérialisée au format JSON dans le corps de la demande.

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

Envoie une requête POST à l’URI spécifié contenant la value sérialisée au format JSON dans le corps de la demande.

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

Envoie une requête POST à l’URI spécifié contenant la value sérialisée au format JSON dans le corps de la demande.

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

Envoie une requête POST à l’URI spécifié contenant la value sérialisée au format JSON dans le corps de la demande.

PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

Envoyez une requête PUT à l’URI spécifié contenant le value sérialisé au format JSON dans le corps de la demande.

PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

Envoyez une requête PUT à l’URI spécifié contenant le value sérialisé au format JSON dans le corps de la demande.

PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

Envoyez une requête PUT à l’URI spécifié contenant le value sérialisé au format JSON dans le corps de la demande.

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

Envoyez une requête PUT à l’URI spécifié contenant le value sérialisé au format JSON dans le corps de la demande.

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

Envoyez une requête PUT à l’URI spécifié contenant le value sérialisé au format JSON dans le corps de la demande.

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

Envoyez une requête PUT à l’URI spécifié contenant le value sérialisé au format JSON dans le corps de la demande.

S’applique à

Voir aussi