共用方式為


HttpClient.GetByteArrayAsync 方法

定義

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

多載

GetByteArrayAsync(String)

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

GetByteArrayAsync(Uri)

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

GetByteArrayAsync(String, CancellationToken)

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

GetByteArrayAsync(Uri, CancellationToken)

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

備註

作業不會封鎖。

GetByteArrayAsync(String)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
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);
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[]>

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

例外狀況

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

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

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

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

備註

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

注意

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

適用於

GetByteArrayAsync(Uri)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
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);
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[]>

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

例外狀況

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

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

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

備註

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

注意

如果逾時:

適用於

GetByteArrayAsync(String, CancellationToken)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
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[]>

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

例外狀況

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

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

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

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

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

注意

如果逾時:

適用於

GetByteArrayAsync(Uri, CancellationToken)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
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[]>

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

例外狀況

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

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

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

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

注意

如果逾時:

適用於