Partager via


HttpClient.SendRequestAsync Méthode

Définition

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

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.

Voir aussi

S’applique à