HttpClient.PostAsync(Uri, IHttpContent) Méthode

Définition

Envoyez une requête POST à l’URI spécifié en tant qu’opération asynchrone. Pour obtenir des conseils de programmation pour la classe HttpClient et des exemples de code, consultez la rubrique conceptuelle 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)

Paramètres

uri
Uri Uri

URI vers lequel la demande est envoyée.

content
IHttpContent

Contenu de la requête HTTP à envoyer au serveur.

Retours

Objet représentant l’opération asynchrone.

Attributs

Exemples

Consultez HttpClient pour obtenir des exemples d’appel de HttpClient.PostAsync.

Remarques

Cette opération ne se bloque pas. L’IAsyncOperationWithProgress (deHttpResponseMessage et HttpProgress) retourné se termine une fois la réponse entière (y compris le contenu) lue.

Les méthodes PostAsync et PutAsync permettent uniquement de définir un nombre limité d’en-têtes de contenu HTTP. En revanche, la méthode SendRequestAsync permet de définir des en-têtes sur le message de demande ainsi que sur le contenu HTTP à envoyer.

Voici les exceptions levées par cette fonction.

E_INVALIDARG

Le paramètre uri était une référence null (Nothing en Visual Basic).

Gestion des exceptions

Vous devez écrire du code pour gérer les exceptions lorsque vous appelez cette méthode. Les exceptions peuvent résulter d’erreurs de validation de paramètres, d’échecs de résolution de noms et d’erreurs réseau. Des exceptions aux erreurs réseau (perte de connectivité, échecs de connexion et échecs de serveur HTTP, par exemple) peuvent se produire à tout moment. Ces erreurs donnent lieu à la levée d’exceptions. Si elle n’est pas gérée par votre application, une exception peut entraîner l’arrêt de l’ensemble de votre application par le runtime. Pour plus d’informations sur la gestion des exceptions, consultez Gestion des exceptions dans les applications réseau.

S’applique à

Voir aussi