HttpClient.GetByteArrayAsync Método
Definición
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 y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica.
Sobrecargas
| GetByteArrayAsync(String) |
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica. |
| GetByteArrayAsync(Uri) |
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica. |
| GetByteArrayAsync(String, CancellationToken) |
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica. |
| GetByteArrayAsync(Uri, CancellationToken) |
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica. |
Comentarios
La operación no se bloqueará.
GetByteArrayAsync(String)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri);member this.GetByteArrayAsync : string -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As String) As Task(Of Byte())Parámetros
- requestUri
- String
URI al que se envía la solicitud.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
requestUri debe ser un URI absoluto o se debe establecer BaseAddress.
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.
Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.
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 todo el cuerpo de la respuesta.
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
GetByteArrayAsync(Uri)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri);member this.GetByteArrayAsync : Uri -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As Uri) As Task(Of Byte())Parámetros
- requestUri
- Uri
URI al que se envía la solicitud.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
requestUri debe ser un URI absoluto o se debe establecer BaseAddress.
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 solo para .NET Framework).
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á después de leer todo el cuerpo de la respuesta.
Nota
En el caso de un tiempo de espera:
- .NET Framework inicia una HttpRequestExceptionexcepción .
- .NET Core inicia una TaskCanceledException excepción sin ninguna excepción interna.
- .NET 5 y versiones posteriores inician un TaskCanceledException que anida un TimeoutException.
Se aplica a
GetByteArrayAsync(String, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetByteArrayAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Byte())Parámetros
- requestUri
- String
URI al que se envía la solicitud.
- cancellationToken
- CancellationToken
Token de cancelación para cancelar la operación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
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 solo para .NET Framework).
Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.
El URI de solicitud proporcionado no es un URI relativo o absoluto válido.
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á después de leer todo el cuerpo de la respuesta.
Nota
En el caso de un tiempo de espera:
- .NET Framework inicia una HttpRequestExceptionexcepción .
- .NET Core inicia una TaskCanceledException excepción sin ninguna excepción interna.
- .NET 5 y versiones posteriores inician un TaskCanceledException que anida un TimeoutException.
Se aplica a
GetByteArrayAsync(Uri, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una matriz de bytes en una operación asincrónica.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetByteArrayAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Byte())Parámetros
- requestUri
- Uri
URI al que se envía la solicitud.
- cancellationToken
- CancellationToken
Token de cancelación para cancelar la operación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
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 solo para .NET Framework).
Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.
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á después de leer todo el cuerpo de la respuesta.
Nota
En el caso de un tiempo de espera:
- .NET Framework inicia una HttpRequestExceptionexcepción .
- .NET Core inicia una TaskCanceledException excepción sin ninguna excepción interna.
- .NET 5 y versiones posteriores inician un TaskCanceledException que anida un TimeoutException.
