HttpClient Classe

Definizione

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à

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 La sezione note sulle 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 il token di richiesta e annullamento specificato.

Send(HttpRequestMessage, CancellationToken)

Invia una richiesta HTTP con il token di richiesta e annullamento specificato.

(Ereditato da HttpMessageInvoker)
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 la value serializzazione come JSON nel corpo della richiesta.

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

Invia una richiesta PATCH all'URI specificato contenente la value serializzazione come JSON nel corpo della richiesta.

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

Invia una richiesta PATCH all'URI specificato contenente la value serializzazione come JSON nel corpo della richiesta.

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

Invia una richiesta PATCH all'URI specificato contenente la value serializzazione come JSON nel corpo della richiesta.

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

Invia una richiesta PATCH all'URI specificato contenente la value serializzazione come JSON nel corpo della richiesta.

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

Invia una richiesta PATCH all'URI specificato contenente la value serializzazione 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.

Si applica a

Vedi anche