HttpClient.GetByteArrayAsync Método

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma matriz de bytes em uma operação assíncrona.

Sobrecargas

GetByteArrayAsync(String)	Envia uma solicitação GET para o Uri especificado e retorna o corpo da resposta como uma matriz de bytes em uma operação assíncrona.
GetByteArrayAsync(Uri)	Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma matriz de bytes em uma operação assíncrona.
GetByteArrayAsync(String, CancellationToken)	Envia uma solicitação GET para o Uri especificado e retorna o corpo da resposta como uma matriz de bytes em uma operação assíncrona.
GetByteArrayAsync(Uri, CancellationToken)	Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma matriz de bytes em uma operação assíncrona.

Comentários

A operação não será bloqueada.

GetByteArrayAsync(String)

Origem:

HttpClient.cs

Envia uma solicitação GET para o Uri especificado e retorna o corpo da resposta como uma matriz de bytes em uma operação assíncrona.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::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

O URI ao qual a solicitação é enviada.

Retornos

Task<Byte[]>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

UriFormatException

O URI de solicitação fornecido não é URI relativo ou absoluto válido.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de tempo limite, diferentes exceções são geradas em diferentes implementações do .NET.

• HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
• TaskCanceledException sem qualquer exceção interna é gerada em todas as versões aplicáveis do .NET Core.
• TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e versões posteriores.

GetByteArrayAsync(Uri)

Origem:

HttpClient.cs

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma matriz de bytes em uma operação assíncrona.

public:
 System::Threading::Tasks::Task<cli::array <System::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

O URI ao qual a solicitação é enviada.

Retornos

Task<Byte[]>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

Falha na solicitação devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor (ou tempo limite apenas para .NET Framework).

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de um tempo limite:

• .NET Framework lança um HttpRequestException.
• O .NET Core gera um TaskCanceledException sem nenhuma exceção interna.
• O .NET 5 e versões posteriores lançam um TaskCanceledException que aninha um TimeoutException.

GetByteArrayAsync(String, CancellationToken)

Origem:

HttpClient.cs

Envia uma solicitação GET para o Uri especificado e retorna o corpo da resposta como uma matriz de bytes em uma operação assíncrona.

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

O URI ao qual a solicitação é enviada.

cancellationToken

CancellationToken

O token de cancelamento para cancelar a operação.

Retornos

Task<Byte[]>

O objeto de tarefa que representa a operação assíncrona.

Exceções

HttpRequestException

Falha na solicitação devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor (ou tempo limite apenas para .NET Framework).

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

UriFormatException

O URI de solicitação fornecido não é URI relativo ou absoluto válido.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de um tempo limite:

• .NET Framework lança um HttpRequestException.
• O .NET Core gera um TaskCanceledException sem nenhuma exceção interna.
• O .NET 5 e versões posteriores lançam um TaskCanceledException que aninha um TimeoutException.

GetByteArrayAsync(Uri, CancellationToken)

Origem:

HttpClient.cs

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma matriz de bytes em uma operação assíncrona.

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

O URI ao qual a solicitação é enviada.

cancellationToken

CancellationToken

O token de cancelamento para cancelar a operação.

Retornos

Task<Byte[]>

O objeto de tarefa que representa a operação assíncrona.

Exceções

HttpRequestException

Falha na solicitação devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor (ou tempo limite apenas para .NET Framework).

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que todo o corpo da resposta for lido.

Observação

No caso de um tempo limite:

• .NET Framework lança um HttpRequestException.
• O .NET Core gera um TaskCanceledException sem nenhuma exceção interna.
• O .NET 5 e versões posteriores lançam um TaskCanceledException que aninha um TimeoutException.