HttpClient.GetAsync Método

Referencia

Definición

Espacio de nombres:: System.Net.Http

Ensamblado:: System.Net.Http.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Envía una solicitud GET al URI especificado como una operación asincrónica.

Sobrecargas

GetAsync(String)	Envía una solicitud GET al URI especificado como una operación asincrónica.
GetAsync(Uri)	Envía una solicitud GET al URI especificado como una operación asincrónica.
GetAsync(String, HttpCompletionOption)	Envía una solicitud GET al URI especificado con una opción de finalización de HTTP como operación asincrónica.
GetAsync(String, CancellationToken)	Envía una solicitud GET al URI especificado con un token de cancelación como operación asincrónica.
GetAsync(Uri, HttpCompletionOption)	Envía una solicitud GET al URI especificado con una opción de finalización de HTTP como operación asincrónica.
GetAsync(Uri, CancellationToken)	Envía una solicitud GET al URI especificado con un token de cancelación como operación asincrónica.
GetAsync(String, HttpCompletionOption, CancellationToken)	Envía una solicitud GET al URI especificado con una opción de finalización de HTTP y un token de cancelación como operación asincrónica.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Envía una solicitud GET al URI especificado con una opción de finalización de HTTP y un token de cancelación como operación asincrónica.

Comentarios

La operación no se bloqueará.

GetAsync(String)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado como una operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri);

member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)

Parámetros

requestUri: String

URI al que se envía la solicitud.

Devoluciones

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

UriFormatException

El URI de solicitud proporcionado no es un URI relativo o absoluto válido.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido). El comportamiento es el mismo que si ResponseContentRead se ha especificado explícitamente.

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.

Se aplica a

GetAsync(Uri)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado como una operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri);

member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

Parámetros

requestUri: Uri

URI al que se envía la solicitud.

Devoluciones

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

Comentarios

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.

Se aplica a

GetAsync(String, HttpCompletionOption)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado con una opción de finalización de HTTP como operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri, System.Net.Http.HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parámetros

requestUri: String

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

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

UriFormatException

El URI de solicitud proporcionado no es un URI relativo o absoluto válido.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará en función del completionOption parámetro después de leer la parte o toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.

Se aplica a

GetAsync(String, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado con un token de cancelación como operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parámetros

requestUri: String

URI al que se envía la solicitud.

cancellationToken: CancellationToken

Token de cancelación que pueden usar otros objetos o subprocesos para recibir el aviso de cancelación.

Devoluciones

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

UriFormatException

El URI de solicitud proporcionado no es un URI relativo o absoluto válido.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.

Se aplica a

GetAsync(Uri, HttpCompletionOption)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado con una opción de finalización de HTTP como operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parámetros

requestUri: Uri

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

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará en función del completionOption parámetro después de leer la parte o toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.

Se aplica a

GetAsync(Uri, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado con un token de cancelación como operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parámetros

requestUri: Uri

URI al que se envía la solicitud.

cancellationToken: CancellationToken

Token de cancelación que pueden usar otros objetos o subprocesos para recibir el aviso de cancelación.

Devoluciones

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida una TimeoutException excepción se produce en .NET 5 y versiones posteriores.

Se aplica a

GetAsync(String, HttpCompletionOption, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado con una opción de finalización de HTTP y un token de cancelación como operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parámetros

requestUri: String

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.

cancellationToken: CancellationToken

Token de cancelación que pueden usar otros objetos o subprocesos para recibir el aviso de cancelación.

Devoluciones

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

UriFormatException

El URI de solicitud proporcionado no es un URI relativo o absoluto válido.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará en función del completionOption parámetro después de leer la parte o toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida una TimeoutException excepción se produce en .NET 5 y versiones posteriores.

Se aplica a

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envía una solicitud GET al URI especificado con una opción de finalización de HTTP y un token de cancelación como operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parámetros

requestUri: Uri

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.

cancellationToken: CancellationToken

Token de cancelación que pueden usar otros objetos o subprocesos para recibir el aviso de cancelación.

Devoluciones

Task<HttpResponseMessage>

Objeto de tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

HttpRequestException

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

TaskCanceledException

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará en función del completionOption parámetro después de leer la parte o toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
TaskCanceledException que anida una TimeoutException excepción se produce en .NET 5 y versiones posteriores.

Se aplica a

Compartir a través de

HttpClient.GetAsync Método

Definición

Sobrecargas

Comentarios

GetAsync(String)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

GetAsync(Uri)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

GetAsync(String, HttpCompletionOption)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

GetAsync(String, CancellationToken)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

GetAsync(Uri, HttpCompletionOption)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

GetAsync(Uri, CancellationToken)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

GetAsync(String, HttpCompletionOption, CancellationToken)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Recursos adicionales