HttpClient.GetAsync Método

Definición

Espacio de nombres:

System.Net.Http

Ensamblado:

System.Net.Http.dll

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

Sobrecargas

Nombre	Description
GetAsync(String)	Envíe una solicitud GET al URI especificado como una operación asincrónica.
GetAsync(Uri)	Envíe una solicitud GET al URI especificado como una operación asincrónica.
GetAsync(String, HttpCompletionOption)	Envíe una solicitud GET al URI especificado con una opción de finalización HTTP como una operación asincrónica.
GetAsync(String, CancellationToken)	Envíe una solicitud GET al URI especificado con un token de cancelación como una operación asincrónica.
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.
GetAsync(Uri, CancellationToken)	Envíe una solicitud GET al URI especificado con un token de cancelación como una operación asincrónica.
GetAsync(String, HttpCompletionOption, CancellationToken)	Envíe una solicitud GET al URI especificado con una opción de finalización HTTP y un token de cancelación como una operación asincrónica.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Envíe una solicitud GET al URI especificado con una opción de finalización HTTP y un token de cancelación como una operación asincrónica.

Comentarios

La operación no se bloqueará.

GetAsync(String)

Envíe 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);

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

Identificador URI al que se envía la solicitud.

Devoluciones

Task<HttpResponseMessage>

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

Excepciones

InvalidOperationException

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError

O bien

solo .NET Framework: se agota el tiempo de espera de la solicitud.

OperationCanceledException

.NET Core y .NET 5 y versiones posteriores solo: 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 bloquea. 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.

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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

GetAsync(Uri)

Envíe 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);

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

Identificador URI al que se envía la solicitud.

Devoluciones

Task<HttpResponseMessage>

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

Excepciones

InvalidOperationException

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError

O bien

solo .NET Framework: se agota el tiempo de espera de la solicitud.

OperationCanceledException

.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloquea. 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.

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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

GetAsync(String, HttpCompletionOption)

Envíe una solicitud GET al URI especificado con una opción de finalización HTTP como una 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);

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

Identificador URI al que se envía la solicitud.

completionOption

HttpCompletionOption

Valor de opción de finalización 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

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

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

OperationCanceledException

.NET Core y .NET 5 y versiones posteriores solo: 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 bloquea. 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).

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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

GetAsync(String, CancellationToken)

Envíe una solicitud GET al URI especificado con un token de cancelación como una 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);

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

Identificador URI al que se envía la solicitud.

cancellationToken

CancellationToken

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

Devoluciones

Task<HttpResponseMessage>

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

Excepciones

InvalidOperationException

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError

O bien

solo .NET Framework: se agota el tiempo de espera de la solicitud.

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.

O bien

.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloquea. 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.

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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

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.

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

Identificador URI al que se envía la solicitud.

completionOption

HttpCompletionOption

Valor de opción de finalización 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

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError

O bien

solo .NET Framework: se agota el tiempo de espera de la solicitud.

OperationCanceledException

.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloquea. 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).

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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

GetAsync(Uri, CancellationToken)

Envíe una solicitud GET al URI especificado con un token de cancelación como una 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);

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

Identificador URI al que se envía la solicitud.

cancellationToken

CancellationToken

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

Devoluciones

Task<HttpResponseMessage>

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

Excepciones

InvalidOperationException

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

No se pudo realizar la solicitud debido a un problema al obtener una respuesta HTTP, como la conectividad de red, el error dns o la validación del certificado de servidor. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError

O bien

solo .NET Framework: se agota el tiempo de espera de la solicitud.

OperationCanceledException

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

O bien

.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloquea. 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.

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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

GetAsync(String, HttpCompletionOption, CancellationToken)

Envíe una solicitud GET al URI especificado con una opción de finalización HTTP y un token de cancelación como una 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);

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

Identificador URI al que se envía la solicitud.

completionOption

HttpCompletionOption

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

cancellationToken

CancellationToken

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

Devoluciones

Task<HttpResponseMessage>

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

Excepciones

InvalidOperationException

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError

O bien

solo .NET Framework: se agota el tiempo de espera de la solicitud.

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.

O bien

.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloquea. 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).

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Envíe una solicitud GET al URI especificado con una opción de finalización HTTP y un token de cancelación como una 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);

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

Identificador URI al que se envía la solicitud.

completionOption

HttpCompletionOption

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

cancellationToken

CancellationToken

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

Devoluciones

Task<HttpResponseMessage>

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

Excepciones

InvalidOperationException

no requestUri es un URI absoluto y BaseAddress no se establece.

HttpRequestException

Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError

O bien

solo .NET Framework: se agota el tiempo de espera de la solicitud.

OperationCanceledException

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

O bien

.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloquea. 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).

Note

En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.

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