HttpClient.GetAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Http

Assembly:

System.Net.Http.dll

Inviare una richiesta GET all'URI specificato come operazione asincrona.

Overload

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)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

UriFormatException

L'URI della richiesta specificato non è un URI relativo o assoluto valido.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intera risposta (contenuto incluso) verrà letta. Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza eccezioni interne viene generata in tutte le versioni di .NET Core applicabili.
• TaskCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.

GetAsync(Uri)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intera risposta (contenuto incluso) verrà letta. Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza eccezioni interne viene generata in tutte le versioni di .NET Core applicabili.
• TaskCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.

GetAsync(String, HttpCompletionOption)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

completionOption

HttpCompletionOption

Valore di opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

UriFormatException

L'URI della richiesta specificato non è un URI relativo o assoluto valido.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato in base al parametro completionOption dopo che le risposte verranno lette parzialmente o totalmente (contenuto incluso).

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza eccezioni interne viene generata in tutte le versioni di .NET Core applicabili.
• TaskCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.

GetAsync(String, CancellationToken)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

cancellationToken

CancellationToken

Token di annullamento utilizzabile da altri oggetti o thread per ricevere l'avviso dell'annullamento.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

UriFormatException

L'URI della richiesta specificato non è un URI relativo o assoluto valido.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intera risposta (contenuto incluso) verrà letta. Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza eccezioni interne viene generata in tutte le versioni di .NET Core applicabili.
• TaskCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.

GetAsync(Uri, HttpCompletionOption)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

completionOption

HttpCompletionOption

Valore di opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato in base al parametro completionOption dopo che le risposte verranno lette parzialmente o totalmente (contenuto incluso).

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza eccezioni interne viene generata in tutte le versioni di .NET Core applicabili.
• TaskCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.

GetAsync(Uri, CancellationToken)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

cancellationToken

CancellationToken

Token di annullamento utilizzabile da altri oggetti o thread per ricevere l'avviso dell'annullamento.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intera risposta (contenuto incluso) verrà letta. Il comportamento è uguale a se ResponseContentRead è stato specificato in modo esplicito.

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili di .NET Core.
• TaskCanceledException che annida un TimeoutException oggetto viene generato in .NET 5 e versioni successive.

GetAsync(String, HttpCompletionOption, CancellationToken)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

completionOption

HttpCompletionOption

Valore di opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.

cancellationToken

CancellationToken

Token di annullamento utilizzabile da altri oggetti o thread per ricevere l'avviso dell'annullamento.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5: la richiesta non è riuscita a causa del timeout.

UriFormatException

L'URI della richiesta fornito non è valido URI relativo o assoluto.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato in base al parametro completionOption dopo che le risposte verranno lette parzialmente o totalmente (contenuto incluso).

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili di .NET Core.
• TaskCanceledException che annida un TimeoutException oggetto viene generato in .NET 5 e versioni successive.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Origine:

HttpClient.cs

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

L'URI a cui viene inviata la richiesta.

completionOption

HttpCompletionOption

Valore di opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.

cancellationToken

CancellationToken

Token di annullamento utilizzabile da altri oggetti o thread per ricevere l'avviso dell'annullamento.

Restituisce

Task<HttpResponseMessage>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5: la richiesta non è riuscita a causa del timeout.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato in base al parametro completionOption dopo che le risposte verranno lette parzialmente o totalmente (contenuto incluso).

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

• HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
• TaskCanceledException senza alcuna eccezione interna viene generata in tutte le versioni applicabili di .NET Core.
• TaskCanceledException che annida un TimeoutException oggetto viene generato in .NET 5 e versioni successive.