HttpClient.PostAsync 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 POST all'URI specificato come operazione asincrona.
Overload
| Nome | Descrizione |
|---|---|
| PostAsync(Uri, HttpContent, CancellationToken) |
Inviare una richiesta POST con un token di annullamento 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) |
Inviare una richiesta POST all'URI specificato come operazione asincrona. |
Commenti
Questa operazione non viene bloccata.
PostAsync(Uri, HttpContent, CancellationToken)
Inviare una richiesta POST con un token di annullamento come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- requestUri
- Uri
URI a cui viene inviata la richiesta.
- content
- HttpContent
Contenuto della richiesta HTTP inviato al server.
- 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 dopo la lettura dell'intera 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
PostAsync(String, HttpContent, CancellationToken)
Inviare una richiesta POST con un token di annullamento come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametri
- requestUri
- String
URI a cui viene inviata la richiesta.
- content
- HttpContent
Contenuto della richiesta HTTP inviato al server.
- 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).
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
PostAsync(String, HttpContent)
Inviare una richiesta POST all'URI specificato come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(string requestUri, System.Net.Http.HttpContent content);member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)Parametri
- requestUri
- String
URI a cui viene inviata la richiesta.
- content
- HttpContent
Contenuto della richiesta HTTP inviato al server.
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).
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
PostAsync(Uri, HttpContent)
Inviare una richiesta POST all'URI specificato come operazione asincrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(Uri requestUri, System.Net.Http.HttpContent content);member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)Parametri
- requestUri
- Uri
URI a cui viene inviata la richiesta.
- content
- HttpContent
Contenuto della richiesta HTTP inviato al server.
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).
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.