HttpClient.PostAsync(Uri, IHttpContent) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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.