HttpClient.PostAsync(Uri, IHttpContent) 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. Per indicazioni sulla programmazione per la classe HttpClient ed esempi di codice, vedere l'argomento concettuale HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ PostAsync(Uri ^ uri, IHttpContent ^ content) = PostAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> PostAsync(Uri const& uri, IHttpContent const& content);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> PostAsync(System.Uri uri, IHttpContent content);function postAsync(uri, content)Public Function PostAsync (uri As Uri, content As IHttpContent) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)Parametri
- content
- IHttpContent
Contenuto della richiesta HTTP da inviare al server.
Restituisce
Oggetto che rappresenta l'operazione asincrona.
- Attributi
Esempio
Per esempi di chiamata a HttpClient.PostAsync, vedere HttpClient.
Commenti
Questa operazione non verrà bloccata. L'oggetto IAsyncOperationWithProgress restituito (diHttpResponseMessage e HttpProgress) viene completato dopo la lettura dell'intera risposta (incluso il contenuto).
I metodi PostAsync e PutAsync consentono solo di impostare un numero limitato di intestazioni di contenuto HTTP. Al contrario, il metodo SendRequestAsync consente di impostare intestazioni sul messaggio di richiesta e sul contenuto HTTP da inviare.
Di seguito sono riportate le eccezioni generate da questa funzione.
E_INVALIDARG
Il parametro URI è un riferimento Null (Nothing in Visual Basic).
Gestione delle eccezioni
È necessario scrivere codice per gestire le eccezioni quando si chiama questo metodo. Le eccezioni possono derivare da errori di convalida dei parametri, errori di risoluzione dei nomi ed errori di rete. Le eccezioni da errori di rete (perdita di connettività, errori di connessione e errori del server HTTP, ad esempio) possono verificarsi in qualsiasi momento. Questi errori causano la generazione di eccezioni. Se non viene gestita dall'app, un'eccezione può causare la terminazione dell'intera app da parte del runtime. Per altre informazioni su come gestire le eccezioni, vedere Gestione delle eccezioni nelle app di rete.