HttpClient.SendRequestAsync 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.
Surcharges
| SendRequestAsync(HttpRequestMessage) |
Envoie une requête HTTP 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 . |
| SendRequestAsync(HttpRequestMessage, HttpCompletionOption) |
Envoyez une requête HTTP avec une option d’achèvement HTTP 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 . |
SendRequestAsync(HttpRequestMessage)
Envoie une requête HTTP 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> ^ SendRequestAsync(HttpRequestMessage ^ request) = SendRequestAsync;/// [Windows.Foundation.Metadata.Overload("SendRequestAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);[Windows.Foundation.Metadata.Overload("SendRequestAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request);function sendRequestAsync(request)Public Function SendRequestAsync (request As HttpRequestMessage) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)Paramètres
- request
- HttpRequestMessage
Message de la requête HTTP à envoyer.
Retours
Objet représentant l’opération asynchrone.
- Attributs
Remarques
Cette opération ne se bloque pas. L’IAsyncOperationWithProgress (de HttpResponseMessage et HttpProgress) retourné se termine une fois la réponse entière (y compris le contenu) lue.
Le HttpRequestMessage transmis dans le paramètre de requête permet à la méthode SendRequestAsync de définir des en-têtes sur le message de requête ainsi que sur le contenu HTTP à envoyer. En revanche, les méthodes PostAsync et PutAsync permettent uniquement de définir un ensemble plus limité d’en-têtes de contenu HTTP.
Voici les exceptions levées par cette fonction.
E_ILLEGAL_METHOD_CALL
Le message de requête a déjà été envoyé par le instance HttpClient.
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 et Guide pratique pour mapper les HRESULT et les exceptions.
Voir aussi
- HttpRequestMessage
- PostAsync(Uri, IHttpContent)
- PutAsync(Uri, IHttpContent)
- SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
- HttpClient
S’applique à
SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
Envoyez une requête HTTP avec une option d’achèvement HTTP 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> ^ SendRequestAsync(HttpRequestMessage ^ request, HttpCompletionOption completionOption) = SendRequestAsync;/// [Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request, HttpCompletionOption const& completionOption);[Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request, HttpCompletionOption completionOption);function sendRequestAsync(request, completionOption)Public Function SendRequestAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)Paramètres
- request
- HttpRequestMessage
Message de la requête HTTP à envoyer.
- completionOption
- HttpCompletionOption
Valeur qui indique si l’opération HttpClient est considérée comme terminée lorsque toute la réponse est lue ou lorsque les en-têtes sont uniquement lus.
Retours
Objet représentant l’opération asynchrone.
- Attributs
Remarques
Cette opération ne se bloque pas. L’IAsyncOperationWithProgress (de HttpResponseMessage et HttpProgress) retourné se termine en fonction de la valeur du paramètre completionOption.
Le HttpRequestMessage transmis dans le paramètre de requête permet à la méthode SendRequestAsync de définir des en-têtes sur le message de requête ainsi que sur le contenu HTTP à envoyer. En revanche, les méthodes PostAsync et PutAsync permettent uniquement de définir un ensemble plus limité d’en-têtes de contenu HTTP.
Voici les exceptions levées par cette fonction.
E_ILLEGAL_METHOD_CALL
Le message de requête a déjà été envoyé par le instance HttpClient.
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 et Guide pratique pour mapper les HRESULT et les exceptions.