HttpClient.GetAsync Metodo
Definizione
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.
Inviare una richiesta GET all'URI specificato come operazione asincrona.
Overload
| Nome | Descrizione |
|---|---|
| GetAsync(String) |
Inviare una richiesta GET all'URI specificato come operazione asincrona. |
| GetAsync(Uri) |
Inviare una richiesta GET all'URI specificato come operazione asincrona. |
| GetAsync(String, HttpCompletionOption) |
Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona. |
| GetAsync(String, 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, 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(Uri, HttpCompletionOption, CancellationToken) |
Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP e un token di annullamento come operazione asincrona. |
Commenti
L'operazione non verrà bloccata.
GetAsync(String)
Inviare una richiesta GET all'URI specificato come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri);member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)Parametri
- requestUri
- String
URI a cui viene inviata la richiesta.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
La richiesta non è riuscita a causa di un problema durante il recupero di una risposta HTTP valida, ad esempio un errore di connettività di rete, un errore DNS, un errore di convalida del certificato del server o una risposta del server non valida. In .NET 8 e versioni successive, il motivo è indicato da HttpRequestError
oppure
solo .NET Framework: timeout della richiesta.
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
L'URI della richiesta fornito non è un URI relativo o assoluto valido.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato dopo la lettura dell'intera risposta (incluso il contenuto). Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.
Si applica a
GetAsync(Uri)
Inviare una richiesta GET all'URI specificato come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri);member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)Parametri
- requestUri
- Uri
URI a cui viene inviata la richiesta.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
La richiesta non è riuscita a causa di un problema durante il recupero di una risposta HTTP valida, ad esempio un errore di connettività di rete, un errore DNS, un errore di convalida del certificato del server o una risposta del server non valida. In .NET 8 e versioni successive, il motivo è indicato da HttpRequestError
oppure
solo .NET Framework: timeout della richiesta.
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato dopo la lettura dell'intera risposta (incluso il contenuto). Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.
Si applica a
GetAsync(String, HttpCompletionOption)
Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parametri
- requestUri
- String
URI a cui viene inviata la richiesta.
- completionOption
- HttpCompletionOption
Valore dell'opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
La richiesta non è riuscita a causa di un problema sottostante, ad esempio connettività di rete, errore DNS, convalida del certificato server o timeout.
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
L'URI della richiesta fornito non è un URI relativo o assoluto valido.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato in base al completionOption parametro dopo la lettura della parte o di tutta la risposta (incluso il contenuto).
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.
Si applica a
GetAsync(String, CancellationToken)
Inviare una richiesta GET all'URI specificato con un token di annullamento come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- requestUri
- String
URI a cui viene inviata la richiesta.
- cancellationToken
- CancellationToken
Token di annullamento che può essere utilizzato da altri oggetti o thread per ricevere un avviso di annullamento.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
La richiesta non è riuscita a causa di un problema durante il recupero di una risposta HTTP valida, ad esempio un errore di connettività di rete, un errore DNS, un errore di convalida del certificato del server o una risposta del server non valida. In .NET 8 e versioni successive, il motivo è indicato da HttpRequestError
oppure
solo .NET Framework: timeout della richiesta.
L'URI della richiesta fornito non è un URI relativo o assoluto valido.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
oppure
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato dopo la lettura dell'intera risposta (incluso il contenuto). Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.
Si applica a
GetAsync(Uri, HttpCompletionOption)
Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parametri
- requestUri
- Uri
URI a cui viene inviata la richiesta.
- completionOption
- HttpCompletionOption
Valore dell'opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
La richiesta non è riuscita a causa di un problema durante il recupero di una risposta HTTP valida, ad esempio un errore di connettività di rete, un errore DNS, un errore di convalida del certificato del server o una risposta del server non valida. In .NET 8 e versioni successive, il motivo è indicato da HttpRequestError
oppure
solo .NET Framework: timeout della richiesta.
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato in base al completionOption parametro dopo la lettura della parte o di tutta la risposta (incluso il contenuto).
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.
Si applica a
GetAsync(Uri, CancellationToken)
Inviare una richiesta GET all'URI specificato con un token di annullamento come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- requestUri
- Uri
URI a cui viene inviata la richiesta.
- cancellationToken
- CancellationToken
Token di annullamento che può essere utilizzato da altri oggetti o thread per ricevere un avviso di annullamento.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
TLa richiesta non è riuscita a causa di un problema durante il recupero di una risposta HTTP, ad esempio la connettività di rete, l'errore DNS o la convalida del certificato del server. In .NET 8 e versioni successive, il motivo è indicato da HttpRequestError
oppure
solo .NET Framework: timeout della richiesta.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
oppure
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato dopo la lettura dell'intera risposta (incluso il contenuto). Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.
Si applica a
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.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- requestUri
- String
URI a cui viene inviata la richiesta.
- completionOption
- HttpCompletionOption
Valore dell'opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.
- cancellationToken
- CancellationToken
Token di annullamento che può essere utilizzato da altri oggetti o thread per ricevere un avviso di annullamento.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
La richiesta non è riuscita a causa di un problema durante il recupero di una risposta HTTP valida, ad esempio un errore di connettività di rete, un errore DNS, un errore di convalida del certificato del server o una risposta del server non valida. In .NET 8 e versioni successive, il motivo è indicato da HttpRequestError
oppure
solo .NET Framework: timeout della richiesta.
L'URI della richiesta fornito non è un URI relativo o assoluto valido.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
oppure
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato in base al completionOption parametro dopo la lettura della parte o di tutta la risposta (incluso il contenuto).
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.
Si applica a
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.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- requestUri
- Uri
URI a cui viene inviata la richiesta.
- completionOption
- HttpCompletionOption
Valore dell'opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.
- cancellationToken
- CancellationToken
Token di annullamento che può essere utilizzato da altri oggetti o thread per ricevere un avviso di annullamento.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Non requestUri è un URI assoluto e BaseAddress non è impostato.
La richiesta non è riuscita a causa di un problema durante il recupero di una risposta HTTP valida, ad esempio un errore di connettività di rete, un errore DNS, un errore di convalida del certificato del server o una risposta del server non valida. In .NET 8 e versioni successive, il motivo è indicato da HttpRequestError
oppure
solo .NET Framework: timeout della richiesta.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
oppure
.NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non viene bloccata. L'oggetto restituito Task<TResult> verrà completato in base al completionOption parametro dopo la lettura della parte o di tutta la risposta (incluso il contenuto).
Note
In caso di timeout, vengono generate eccezioni diverse in implementazioni di .NET diverse.
- HttpRequestException viene generata in tutte le versioni applicabili di .NET Framework.
- OperationCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili .NET Core.
- OperationCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.