HttpClient Classe

Definizione

Spazio dei nomi:

System.Net.Http

Assembly:

System.Net.Http.dll

Source:

HttpClient.cs

Fornisce una classe per l'invio di richieste HTTP e la ricezione di risposte HTTP da una risorsa identificata da 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

Ereditarietà

Object

HttpMessageInvoker

HttpClient

Esempio

// 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

Commenti

Per altre informazioni su questa API, vedere Osservazioni api supplementari per HttpClient.

Costruttori

HttpClient()	Inizializza una nuova istanza della classe HttpClient con HttpClientHandler che viene eliminato quando viene eliminata l'istanza.
HttpClient(HttpMessageHandler)	Inizializza una nuova istanza della classe HttpClient con il gestore specificato. Il gestore viene eliminato quando viene eliminata l'istanza.
HttpClient(HttpMessageHandler, Boolean)	Inizializza una nuova istanza della classe HttpClient con il gestore specificato e stabilisce se il gestore deve essere eliminato quando viene eliminata l'istanza.

Proprietà

BaseAddress	Ottiene o imposta l'indirizzo di base dell'URI (Uniform Resource Identifier) della risorsa Internet usata quando si inviano le richieste.
DefaultProxy	Ottiene o imposta il proxy HTTP globale.
DefaultRequestHeaders	Ottiene le intestazioni che devono essere inviate con ogni richiesta.
DefaultRequestVersion	Ottiene o imposta la versione HTTP predefinita usata per le richieste successive effettuate da questa istanza di HttpClient.
DefaultVersionPolicy	Ottiene o imposta i criteri di versione predefiniti per le richieste create in modo implicito nei metodi pratici, ad esempio GetAsync(String) e PostAsync(String, HttpContent).
MaxResponseContentBufferSize	Ottiene o imposta il numero massimo di byte per la memorizzazione nel buffer durante la lettura del contenuto della risposta.
Timeout	Ottiene o imposta l'intervallo di tempo da attendere prima che si verifichi il timeout della richiesta.

Metodi

CancelPendingRequests()	Annullare tutte le richieste in sospeso in questa istanza.
DeleteAsync(String)	Inviare una richiesta DELETE all'URI specificato come operazione asincrona.
DeleteAsync(String, CancellationToken)	Inviare una richiesta DELETE all'URI specificato con un token di annullamento come operazione asincrona.
DeleteAsync(Uri)	Inviare una richiesta DELETE all'URI specificato come operazione asincrona.
DeleteAsync(Uri, CancellationToken)	Inviare una richiesta DELETE all'URI specificato con un token di annullamento come operazione asincrona.
Dispose()	Rilascia le risorse non gestite ed elimina le risorse gestite utilizzate dall'oggetto HttpMessageInvoker. (Ereditato da HttpMessageInvoker)
Dispose(Boolean)	Rilascia le risorse non gestite usate da HttpClient e, facoltativamente, elimina le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetAsync(String)	Inviare una richiesta GET all'URI specificato come operazione asincrona.
GetAsync(String, CancellationToken)	Inviare una richiesta GET all'URI specificato con un token di annullamento come operazione asincrona.
GetAsync(String, HttpCompletionOption)	Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona.
GetAsync(String, HttpCompletionOption, CancellationToken)	Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP e un token di annullamento come operazione asincrona.
GetAsync(Uri)	Inviare una richiesta GET all'URI specificato come operazione asincrona.
GetAsync(Uri, CancellationToken)	Inviare una richiesta GET all'URI specificato con un token di annullamento come operazione asincrona.
GetAsync(Uri, HttpCompletionOption)	Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP e un token di annullamento come operazione asincrona.
GetByteArrayAsync(String)	Invia una richiesta GET all'URI specificato e restituisce il corpo della risposta come matrice di byte in un'operazione asincrona.
GetByteArrayAsync(String, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il corpo della risposta come matrice di byte in un'operazione asincrona.
GetByteArrayAsync(Uri)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come matrice di byte in un'operazione asincrona.
GetByteArrayAsync(Uri, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come matrice di byte in un'operazione asincrona.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetStreamAsync(String)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come flusso in un'operazione asincrona.
GetStreamAsync(String, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come flusso in un'operazione asincrona.
GetStreamAsync(Uri)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come flusso in un'operazione asincrona.
GetStreamAsync(Uri, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come flusso in un'operazione asincrona.
GetStringAsync(String)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
GetStringAsync(String, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
GetStringAsync(Uri)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
GetStringAsync(Uri, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
PatchAsync(String, HttpContent)	Invia una richiesta PATCH come operazione asincrona a un URI designato come stringa.
PatchAsync(String, HttpContent, CancellationToken)	Invia una richiesta PATCH con un token di annullamento come operazione asincrona a un URI rappresentato come stringa.
PatchAsync(Uri, HttpContent)	Invia una richiesta PATCH come operazione asincrona.
PatchAsync(Uri, HttpContent, CancellationToken)	Invia una richiesta PATCH con un token di annullamento come operazione asincrona.
PostAsync(String, HttpContent)	Inviare una richiesta POST all'URI specificato come operazione asincrona.
PostAsync(String, HttpContent, CancellationToken)	Inviare una richiesta POST con un token di annullamento come operazione asincrona.
PostAsync(Uri, HttpContent)	Inviare una richiesta POST all'URI specificato come operazione asincrona.
PostAsync(Uri, HttpContent, CancellationToken)	Inviare una richiesta POST con un token di annullamento come operazione asincrona.
PutAsync(String, HttpContent)	Inviare una richiesta PUT all'URI specificato come operazione asincrona.
PutAsync(String, HttpContent, CancellationToken)	Inviare una richiesta PUT con un token di annullamento come operazione asincrona.
PutAsync(Uri, HttpContent)	Inviare una richiesta PUT all'URI specificato come operazione asincrona.
PutAsync(Uri, HttpContent, CancellationToken)	Inviare una richiesta PUT con un token di annullamento come operazione asincrona.
Send(HttpRequestMessage)	Invia una richiesta HTTP con la richiesta specificata.
Send(HttpRequestMessage, CancellationToken)	Invia una richiesta HTTP con la richiesta e il token di annullamento specificati.
Send(HttpRequestMessage, HttpCompletionOption)	Invia una richiesta HTTP.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Invia una richiesta HTTP con la richiesta, l'opzione di completamento e il token di annullamento specificati.
SendAsync(HttpRequestMessage)	Inviare una richiesta HTTP come operazione asincrona.
SendAsync(HttpRequestMessage, CancellationToken)	Inviare una richiesta HTTP come operazione asincrona.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Inviare una richiesta HTTP come operazione asincrona.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Inviare una richiesta HTTP come operazione asincrona.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Metodi di estensione

DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Invia una richiesta DELETE all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Invia una HTTP GET richiesta all'oggetto specificato requestUri e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione enumerabile asincrona.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Invia una HTTP GETrichiesta all'oggetto specificato requestUri e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione enumerabile asincrona.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)	Invia una HTTP GETrichiesta all'oggetto specificato requestUri e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione enumerabile asincrona.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Invia una HTTP GETrichiesta all'oggetto specificato requestUri e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione enumerabile asincrona.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Invia una HTTP GETrichiesta all'oggetto specificato requestUri e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione enumerabile asincrona.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)	Invia una HTTP GETrichiesta all'oggetto specificato requestUri e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione enumerabile asincrona.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync(HttpClient, String, Type, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il valore risultante dalla deserializzazione del corpo della risposta come JSON in un'operazione asincrona.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Invia una richiesta PATCH all'URI specificato contenente il value serializzato come JSON nel corpo della richiesta.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta PATCH all'URI specificato contenente il value serializzato come JSON nel corpo della richiesta.
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Invia una richiesta PATCH all'URI specificato contenente il value serializzato come JSON nel corpo della richiesta.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Invia una richiesta PATCH all'URI specificato contenente il value serializzato come JSON nel corpo della richiesta.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta PATCH all'URI specificato contenente il value serializzato come JSON nel corpo della richiesta.
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Invia una richiesta PATCH all'URI specificato contenente il value serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Invia una richiesta POST all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta POST all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Invia una richiesta POST all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Invia una richiesta POST all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta POST all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Invia una richiesta POST all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Invia una richiesta PUT all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta PUT all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Invia una richiesta PUT all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Invia una richiesta PUT all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta PUT all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Invia una richiesta PUT all'URI specificato contenente value serializzato come JSON nel corpo della richiesta.

Vedi anche

• Linee guida per l'uso di HttpClient
• Esempio con HttpClient