HttpClient.GetByteArrayAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come matrice di byte in un'operazione asincrona.

Overload

GetByteArrayAsync(String)	Invia una richiesta GET all'URI specificato e restituisce il corpo della risposta come matrice di byte in un'operazione asincrona.
GetByteArrayAsync(Uri)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come matrice di byte in un'operazione asincrona.
GetByteArrayAsync(String, CancellationToken)	Invia una richiesta GET all'URI specificato e restituisce il corpo della risposta come matrice di byte in un'operazione asincrona.
GetByteArrayAsync(Uri, CancellationToken)	Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come matrice di byte in un'operazione asincrona.

Commenti

L'operazione non verrà bloccata.

GetByteArrayAsync(String)

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Invia una richiesta GET all'URI specificato e restituisce il corpo della risposta come matrice di byte in un'operazione asincrona.

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())

Parametri

requestUri: String

L'URI a cui viene inviata la richiesta.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS, di convalida del certificato server o di timeout.

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

UriFormatException

L'URI della richiesta specificato non è un URI relativo o assoluto valido.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.

Nota

In caso di timeout, vengono generate eccezioni diverse in implementazioni .NET diverse.

HttpRequestException viene generata in tutte le versioni di .NET Framework applicabili.
TaskCanceledException senza eccezioni interne viene generata in tutte le versioni di .NET Core applicabili.
TaskCanceledException che annida un TimeoutException viene generato in .NET 5 e versioni successive.

Si applica a

.NET 9 e altre versioni

Prodotto	Versioni
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetByteArrayAsync(Uri)

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come matrice di byte in un'operazione asincrona.

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())

Parametri

requestUri: Uri

L'URI a cui viene inviata la richiesta.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

requestUri deve essere un URI assoluto o deve essere impostato BaseAddress.

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS o di convalida del certificato server (o di timeout solo per .NET Framework).

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.

Nota

In caso di timeout:

.NET Framework genera un'eccezione HttpRequestException.
.NET Core genera un'eccezione TaskCanceledException senza eccezioni interne.
.NET 5 e versioni successive generano un'eccezione TaskCanceledException che annida un oggetto TimeoutException.

Si applica a

.NET 9 e altre versioni

Prodotto	Versioni
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetByteArrayAsync(String, CancellationToken)

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Invia una richiesta GET all'URI specificato e restituisce il corpo della risposta come matrice di byte in un'operazione asincrona.

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())

Parametri

requestUri: String

L'URI a cui viene inviata la richiesta.

cancellationToken: CancellationToken

Token di annullamento per annullare l'operazione.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS o di convalida del certificato server (o di timeout solo per .NET Framework).

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

UriFormatException

L'URI della richiesta specificato non è un URI relativo o assoluto valido.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.

Nota

In caso di timeout:

.NET Framework genera un'eccezione HttpRequestException.
.NET Core genera un'eccezione TaskCanceledException senza eccezioni interne.
.NET 5 e versioni successive generano un'eccezione TaskCanceledException che annida un oggetto TimeoutException.

Si applica a

.NET 9 e altre versioni

Prodotto	Versioni
.NET	5, 6, 7, 8, 9

GetByteArrayAsync(Uri, CancellationToken)

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Origine:: HttpClient.cs

Inviare una richiesta GET all'URI specificato e restituire il corpo della risposta come matrice di byte in un'operazione asincrona.

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())

Parametri

requestUri: Uri

L'URI a cui viene inviata la richiesta.

cancellationToken: CancellationToken

Token di annullamento per annullare l'operazione.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

HttpRequestException

La richiesta non è riuscita a causa di un problema sottostante, ad esempio un problema di connettività di rete, del DNS o di convalida del certificato server (o di timeout solo per .NET Framework).

TaskCanceledException

Solo .NET Core e .NET 5 e versioni successive: la richiesta non è riuscita a causa del timeout.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo che l'intero corpo della risposta verrà letto.

Nota

In caso di timeout:

.NET Framework genera un'eccezione HttpRequestException.
.NET Core genera un'eccezione TaskCanceledException senza eccezioni interne.
.NET 5 e versioni successive generano un'eccezione TaskCanceledException che annida un oggetto TimeoutException.

Si applica a

.NET 9 e altre versioni

Prodotto	Versioni
.NET	5, 6, 7, 8, 9

Condividi tramite

HttpClient.GetByteArrayAsync Metodo

Definizione

Overload

Commenti

GetByteArrayAsync(String)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

GetByteArrayAsync(Uri)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

GetByteArrayAsync(String, CancellationToken)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

GetByteArrayAsync(Uri, CancellationToken)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Risorse aggiuntive