HttpClient.GetAsync Método

Definición

Espacio de nombres:

Windows.Web.Http

Sobrecargas

GetAsync(Uri)	Envía una solicitud GET al URI especificado como una operación asincrónica. Para obtener instrucciones de programación para la clase HttpClient y ejemplos de código, consulte el tema conceptual HttpClient .
GetAsync(Uri, HttpCompletionOption)	Envíe una solicitud GET al URI especificado con una opción de finalización HTTP como una operación asincrónica. Para obtener instrucciones de programación para la clase HttpClient y ejemplos de código, consulte el tema conceptual HttpClient .

GetAsync(Uri)

Envía una solicitud GET al URI especificado como una operación asincrónica. Para obtener instrucciones de programación para la clase HttpClient y ejemplos de código, consulte el tema conceptual 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)

Parámetros

uri

Uri Uri

Identificador URI al que se va a enviar la solicitud.

Devoluciones

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

Objeto que representa la operación asincrónica.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

Esta operación no se bloqueará. La IAsyncOperationWithProgress devuelta (de HttpResponseMessage y HttpProgress) se completa después de leer toda la respuesta (incluido el contenido).

Para obtener código de ejemplo en C#/VB/C++ y XAML que muestra cómo usar HttpClient y GetAsync(Uri) para conectarse a un servidor HTTP y enviar una solicitud GET, consulte HttpClient.

Para obtener código de ejemplo en JavaScript y HTML que muestra cómo usar HttpClient y GetAsync(Uri) para conectarse a un servidor HTTP y enviar una solicitud GET, consulte Conexión a un servidor HTTP mediante Windows.Web.Http.

A continuación se muestran las excepciones que produce esta función.

COMException

Se produce cuando se devuelve un HRESULT específico de la característica desde una llamada de método.

Esta es la excepción más común que inician los métodos de red. Una aplicación debe usar HRESULT de la excepción para determinar la causa del error.

AccessDeniedException

Se produce cuando se deniega el acceso a un recurso o a una característica. Esta excepción se produce cuando una aplicación no tiene establecidas las funcionalidades de red necesarias en el manifiesto de la aplicación para la operación de red solicitada.

InvalidArgumentException

Se produce cuando uno de los argumentos que se proporcionan a un método no es válido.

Si la entrada proporcionada por el usuario provocó esta excepción, una aplicación podría informar al usuario y solicitar una nueva entrada.

ObjectDisposedException

Se produce cuando se realiza una operación en un objeto desechado.

OutOfMemoryException

Se produce cuando la memoria insuficiente está disponible para completar la operación.

Consulte también

• GetAsync(Uri, HttpCompletionOption)
• IAsyncOperationWithProgress<TResult,TProgress>
• Uri
• Windows.Web.Http
• Conexión a un servidor HTTP mediante Windows.Web.Http
• Control de excepciones en aplicaciones de red
• HttpResponseMessage
• HttpProgress
• System.Uri
• HttpClient

GetAsync(Uri, HttpCompletionOption)

Envíe una solicitud GET al URI especificado con una opción de finalización HTTP como una operación asincrónica. Para obtener instrucciones de programación para la clase HttpClient y ejemplos de código, consulte el tema conceptual 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)

Parámetros

uri

Uri Uri

El URI al que se envía la solicitud.

completionOption

HttpCompletionOption

Valor de opción de finalización de HTTP que indica cuándo se debe considerar completada la operación.

Devoluciones

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

Objeto que representa la operación asincrónica.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

Esta operación no se bloqueará. La IAsyncOperationWithProgress devuelta (de HttpResponseMessage y HttpProgress) se completa en función del parámetro completionOption después de leer parte o toda la respuesta (incluido el contenido).

A continuación se muestran las excepciones que produce este contenido.

COMException

Se produce cuando se devuelve un HRESULT específico de la característica desde una llamada de método.

Esta es la excepción más común que inician los métodos de red. Una aplicación debe usar HRESULT de la excepción para determinar la causa del error.

AccessDeniedException

Se produce cuando se deniega el acceso a un recurso o a una característica. Esta excepción se produce cuando una aplicación no tiene establecidas las funcionalidades de red necesarias en el manifiesto de la aplicación para la operación de red solicitada.

InvalidArgumentException

Se produce cuando uno de los argumentos que se proporcionan a un método no es válido.

Si la entrada proporcionada por el usuario provocó esta excepción, una aplicación podría informar al usuario y solicitar una nueva entrada.

ObjectDisposedException

Se produce cuando se realiza una operación en un objeto desechado.

OutOfMemoryException

Se produce cuando la memoria insuficiente está disponible para completar la operación.

Consulte también

• GetAsync(Uri)
• HttpCompletionOption
• IAsyncOperationWithProgress<TResult,TProgress>
• Uri
• Windows.Web.Http
• Conexión a un servidor HTTP mediante Windows.Web.Http
• Control de excepciones en aplicaciones de red
• HttpResponseMessage
• HttpProgress
• System.Uri
• HttpClient