Partager via


HttpClient.GetAsync Méthode

Définition

Surcharges

GetAsync(Uri)

Envoie une requête GET vers l'URI spécifié sous forme d'opération asynchrone. Pour obtenir des conseils de programmation pour la classe HttpClient et des exemples de code, consultez la rubrique conceptuelle HttpClient .

GetAsync(Uri, HttpCompletionOption)

Envoyez une requête GET à l’URI spécifié avec une option de saisie semi-automatique 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 .

GetAsync(Uri)

Envoie une requête GET vers l'URI spécifié sous forme d'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> ^ GetAsync(Uri ^ uri) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri);
[Windows.Foundation.Metadata.Overload("GetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri);
function getAsync(uri)
Public Function GetAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Paramètres

uri
Uri Uri

URI auquel la demande doit être envoyée.

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.

Pour obtenir un exemple de code en C#/VB/C++ et XAML qui montre comment utiliser HttpClient et GetAsync(Uri) pour se connecter à un serveur HTTP et envoyer une requête GET, consultez HttpClient.

Pour obtenir un exemple de code en JavaScript et HTML qui montre comment utiliser HttpClient et GetAsync(Uri) pour se connecter à un serveur HTTP et envoyer une requête GET, consultez Connexion à un serveur HTTP à l’aide de Windows.Web.Http.

Voici les exceptions levées par cette fonction.

COMException

Levée lorsqu’un HRESULT spécifique à une fonctionnalité est retourné à partir d’un appel de méthode.

Il s’agit de l’exception la plus courante levée par les méthodes de mise en réseau. Une application doit utiliser le HRESULT de l’exception pour déterminer la cause de l’erreur.

AccessDeniedException

Levée lorsque l'accès est refusé à une ressource ou à une fonctionnalité. Cette exception se produit lorsqu’une application n’a pas les fonctionnalités réseau requises définies dans le manifeste de l’application pour l’opération réseau demandée.

InvalidArgumentException

Levée lorsque l'un des arguments fournis à une méthode n'est pas valide.

Si l’entrée fournie par l’utilisateur a provoqué cette exception, une application peut informer l’utilisateur et demander une nouvelle entrée.

ObjectDisposedException

Levée lorsqu'une opération est exécutée sur un objet supprimé.

OutOfMemoryException

Levée lorsque la mémoire disponible est insuffisante pour terminer l’opération.

Voir aussi

S’applique à

GetAsync(Uri, HttpCompletionOption)

Envoyez une requête GET à l’URI spécifié avec une option de saisie semi-automatique 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> ^ GetAsync(Uri ^ uri, HttpCompletionOption completionOption) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri, HttpCompletionOption const& completionOption);
[Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri, HttpCompletionOption completionOption);
function getAsync(uri, completionOption)
Public Function GetAsync (uri As Uri, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Paramètres

uri
Uri Uri

Uri auquel la demande est envoyée.

completionOption
HttpCompletionOption

Valeur d'option d'achèvement HTTP qui indique quand l'opération doit être considérée comme terminée.

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 du paramètre completionOption après la lecture d’une partie ou de la totalité de la réponse (y compris le contenu).

Voici les exceptions levées par ce contenu.

COMException

Levée lorsqu’un HRESULT spécifique à une fonctionnalité est retourné à partir d’un appel de méthode.

Il s’agit de l’exception la plus courante levée par les méthodes de mise en réseau. Une application doit utiliser le HRESULT de l’exception pour déterminer la cause de l’erreur.

AccessDeniedException

Levée lorsque l'accès est refusé à une ressource ou à une fonctionnalité. Cette exception se produit lorsqu’une application n’a pas les fonctionnalités réseau requises définies dans le manifeste de l’application pour l’opération réseau demandée.

InvalidArgumentException

Levée lorsque l'un des arguments fournis à une méthode n'est pas valide.

Si l’entrée fournie par l’utilisateur a provoqué cette exception, une application peut informer l’utilisateur et demander une nouvelle entrée.

ObjectDisposedException

Levée lorsqu'une opération est exécutée sur un objet supprimé.

OutOfMemoryException

Levée lorsque la mémoire disponible est insuffisante pour terminer l’opération.

Voir aussi

S’applique à