HttpClient.GetByteArrayAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應內容。

多載

GetByteArrayAsync(String)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應主體。
GetByteArrayAsync(Uri)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應內容。
GetByteArrayAsync(String, CancellationToken)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應主體。
GetByteArrayAsync(Uri, CancellationToken)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應內容。

備註

作業不會封鎖。

GetByteArrayAsync(String)

Source:

HttpClient.cs

將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應主體。

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

參數

requestUri

String

傳送要求的目標 URI。

傳回

Task<Byte[]>

工作物件，表示非同步作業。

例外狀況

InvalidOperationException

requestUri 必須是絕對 URI，否則必須設定 BaseAddress。

HttpRequestException

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

UriFormatException

所提供的要求 URI 不是有效的相對或絕對 URI。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應主體之後完成。

注意

如果逾時，不同的 .NET 實作會擲回不同的例外狀況。

• HttpRequestException會在所有適用的.NET Framework版本上擲回。
• TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
• TaskCanceledExceptionTimeoutException，會在 .NET 5 和更新版本上擲回 巢狀 。

GetByteArrayAsync(Uri)

Source:

HttpClient.cs

將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應內容。

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

參數

requestUri

Uri

傳送要求的目標 URI。

傳回

Task<Byte[]>

工作物件，表示非同步作業。

例外狀況

InvalidOperationException

requestUri 必須是絕對 URI，否則必須設定 BaseAddress。

HttpRequestException

要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應主體之後完成。

注意

如果逾時：

• .NET Framework會擲回 HttpRequestException 。
• .NET Core 會擲回 ， TaskCanceledException 但沒有任何內部例外狀況。
• .NET 5 和更新版本擲回 TaskCanceledException 巢狀 的 TimeoutException 。

GetByteArrayAsync(String, CancellationToken)

Source:

HttpClient.cs

將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應主體。

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

參數

requestUri

String

傳送要求的目標 URI。

cancellationToken

CancellationToken

用於取消作業的取消權杖。

傳回

Task<Byte[]>

工作物件，表示非同步作業。

例外狀況

HttpRequestException

要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

UriFormatException

所提供的要求 URI 不是有效的相對或絕對 URI。

OperationCanceledException

解除標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應主體之後完成。

注意

如果逾時：

• .NET Framework會擲回 HttpRequestException 。
• .NET Core 會擲回 ， TaskCanceledException 但沒有任何內部例外狀況。
• .NET 5 和更新版本擲回 TaskCanceledException 巢狀 的 TimeoutException 。

GetByteArrayAsync(Uri, CancellationToken)

Source:

HttpClient.cs

將 GET 要求傳送至指定的 URI，並透過非同步作業，以位元組陣列形式傳回回應內容。

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

參數

requestUri

Uri

傳送要求的目標 URI。

cancellationToken

CancellationToken

用於取消作業的取消權杖。

傳回

Task<Byte[]>

工作物件，表示非同步作業。

例外狀況

HttpRequestException

要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

OperationCanceledException

解除標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應主體之後完成。

注意

如果逾時：

• .NET Framework會擲回 HttpRequestException 。
• .NET Core 會擲回 ， TaskCanceledException 但沒有任何內部例外狀況。
• .NET 5 和更新版本擲回 TaskCanceledException 巢狀 的 TimeoutException 。