HttpClient.SendAsync 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 HTTP come operazione asincrona.
Overload
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Inviare una richiesta HTTP come operazione asincrona. |
| SendAsync(HttpRequestMessage) |
Inviare una richiesta HTTP come operazione asincrona. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Inviare una richiesta HTTP come operazione asincrona. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Inviare una richiesta HTTP come operazione asincrona. |
Commenti
Questa operazione non verrà bloccata.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta HTTP come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- request
- HttpRequestMessage
Messaggio di richiesta HTTP da inviare.
- completionOption
- HttpCompletionOption
Quando l'operazione deve essere completata (non appena la risposta è disponibile o dopo aver letto l'intero contenuto della risposta).
- cancellationToken
- CancellationToken
Token di annullamento per annullare l'operazione.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'elemento request è null.
Il messaggio di richiesta è già stato inviato dall'istanza di HttpClient.
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.
Solo .NET Core e .NET 5: la richiesta non è riuscita a causa del timeout.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
Questa operazione non verrà bloccata. A seconda del valore del completionOption parametro, l'oggetto restituito Task<TResult> verrà completato non appena è disponibile una risposta o l'intera risposta inclusa nel contenuto viene letto.
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.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Send(HttpRequestMessage, HttpCompletionOption).
Si applica a
SendAsync(HttpRequestMessage)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta HTTP come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request);override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)Parametri
- request
- HttpRequestMessage
Messaggio di richiesta HTTP da inviare.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'elemento request è null.
Il messaggio di richiesta è già stato inviato dall'istanza di HttpClient.
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.
Solo .NET Core e .NET 5: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non verrà 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.
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.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Send(HttpRequestMessage).
Si applica a
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta HTTP come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parametri
- request
- HttpRequestMessage
Messaggio di richiesta HTTP da inviare.
- completionOption
- HttpCompletionOption
Quando l'operazione deve essere completata (non appena la risposta è disponibile o dopo aver letto l'intero contenuto della risposta).
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'elemento request è null.
Il messaggio di richiesta è già stato inviato dall'istanza di HttpClient.
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.
Solo .NET Core e .NET 5: la richiesta non è riuscita a causa del timeout.
Commenti
Questa operazione non verrà bloccata. A seconda del valore del completionOption parametro, l'oggetto restituito Task<TResult> verrà completato non appena è disponibile una risposta o l'intera risposta inclusa nel contenuto viene letto.
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.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Send(HttpRequestMessage, HttpCompletionOption).
Si applica a
SendAsync(HttpRequestMessage, CancellationToken)
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
- Origine:
- HttpClient.cs
Inviare una richiesta HTTP come operazione asincrona.
public:
override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- request
- HttpRequestMessage
Messaggio di richiesta HTTP da inviare.
- cancellationToken
- CancellationToken
Token di annullamento per annullare l'operazione.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
L'elemento request è null.
Il messaggio di richiesta è già stato inviato dall'istanza di HttpClient.
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.
Solo .NET Core e .NET 5: la richiesta non è riuscita a causa del timeout.
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 la lettura dell'intera risposta, incluso il contenuto. 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.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Send(HttpRequestMessage).
