HttpClient Classe

Definizione

Spazio dei nomi:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll, System.Net.Http.dll

Assembly:: netstandard.dll

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 supplementari sulle API per HttpClient.

Costruttori

Nome	Descrizione
HttpClient()	Inizializza una nuova istanza della HttpClient classe utilizzando un HttpClientHandler oggetto eliminato quando questa istanza viene eliminata.
HttpClient(HttpMessageHandler, Boolean)	Inizializza una nuova istanza della HttpClient classe con il gestore fornito e specifica se tale gestore deve essere eliminato quando questa istanza viene eliminata.
HttpClient(HttpMessageHandler)	Inizializza una nuova istanza della HttpClient classe con il gestore specificato. Il gestore viene eliminato quando questa istanza viene eliminata.

Proprietà

Nome	Descrizione
BaseAddress	Ottiene o imposta l'indirizzo di base dell'URI (Uniform Resource Identifier) della risorsa Internet utilizzata durante l'invio delle 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 utilizzata nelle richieste successive effettuate da questa HttpClient istanza.
DefaultVersionPolicy	Ottiene o imposta i criteri di versione predefiniti per le richieste create in modo implicito nei metodi pratici, GetAsync(String) ad esempio e PostAsync(String, HttpContent).
MaxResponseContentBufferSize	Ottiene o imposta il numero massimo di byte da memorizzare nel buffer durante la lettura del contenuto della risposta.
Timeout	Ottiene o imposta l'intervallo di tempo di attesa prima del timeout della richiesta.

Metodi

Nome	Descrizione
CancelPendingRequests()	Annullare tutte le richieste in sospeso in questa istanza.
DeleteAsync(String, CancellationToken)	Inviare una richiesta DELETE all'URI specificato con un token di annullamento come operazione asincrona.
DeleteAsync(String)	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.
DeleteAsync(Uri)	Inviare una richiesta DELETE all'URI specificato come operazione asincrona.
Dispose()	Rilascia le risorse non gestite ed elimina le risorse gestite usate da 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, CancellationToken)	Inviare una richiesta GET all'URI specificato con un token di annullamento 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(String, HttpCompletionOption)	Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona.
GetAsync(String)	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, CancellationToken)	Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP e 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)	Inviare una richiesta GET all'URI specificato come 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(String)	Invia una richiesta GET all'URI specificato e restituisce 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.
GetByteArrayAsync(Uri)	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, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come flusso in un'operazione asincrona.
GetStreamAsync(String)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come flusso in un'operazione asincrona.
GetStreamAsync(Uri, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come flusso in un'operazione asincrona.
GetStreamAsync(Uri)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come flusso in un'operazione asincrona.
GetStringAsync(String, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come stringa in un'operazione asincrona.
GetStringAsync(String)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come stringa in un'operazione asincrona.
GetStringAsync(Uri, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come stringa in un'operazione asincrona.
GetStringAsync(Uri)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come stringa in un'operazione asincrona.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
PatchAsync(String, HttpContent, CancellationToken)	Invia una richiesta PATCH con un token di annullamento a un URI rappresentato come stringa come operazione asincrona.
PatchAsync(String, HttpContent)	Invia una richiesta PATCH a un URI designato come stringa come operazione asincrona.
PatchAsync(Uri, HttpContent, CancellationToken)	Invia una richiesta PATCH con un token di annullamento come operazione asincrona.
PatchAsync(Uri, HttpContent)	Invia una richiesta PATCH come operazione asincrona.
PostAsync(String, HttpContent, CancellationToken)	Inviare una richiesta POST con un token di annullamento come operazione asincrona.
PostAsync(String, 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.
PostAsync(Uri, HttpContent)	Inviare una richiesta POST all'URI specificato come operazione asincrona.
PutAsync(String, HttpContent, CancellationToken)	Inviare una richiesta PUT con un token di annullamento come operazione asincrona.
PutAsync(String, 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.
PutAsync(Uri, HttpContent)	Inviare una richiesta PUT all'URI specificato come operazione asincrona.
Send(HttpRequestMessage, CancellationToken)	Invia una richiesta HTTP con la richiesta e il token di annullamento specificati.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Invia una richiesta HTTP con la richiesta, l'opzione di completamento e il token di annullamento specificati.
Send(HttpRequestMessage, HttpCompletionOption)	Invia una richiesta HTTP.
Send(HttpRequestMessage)	Invia una richiesta HTTP con la richiesta specificata.
SendAsync(HttpRequestMessage, CancellationToken)	Inviare una richiesta HTTP come operazione asincrona.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Inviare una richiesta HTTP come operazione asincrona.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Inviare una richiesta HTTP come operazione asincrona.
SendAsync(HttpRequestMessage)	Inviare una richiesta HTTP come operazione asincrona.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Metodi di estensione

Nome	Descrizione
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, 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, 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, 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, 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, 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, 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.
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.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, 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 asincrona enumerabile.
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 asincrona enumerabile.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, 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 asincrona enumerabile.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, 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 asincrona enumerabile.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, 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 asincrona enumerabile.
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, 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 asincrona enumerabile.
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, 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, 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, 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, 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, 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, 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.
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.
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, 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, Uri, 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.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Invia una richiesta POST 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 il `value` serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta POST all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Invia una richiesta POST all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Invia una richiesta POST all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Invia una richiesta POST all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)	Inviare una richiesta PUT all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)	Inviare una richiesta PUT all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)	Inviare una richiesta PUT all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)	Inviare una richiesta PUT all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)	Inviare una richiesta PUT all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)	Inviare una richiesta PUT all'URI specificato contenente il `value` serializzato come JSON nel corpo della richiesta.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?