File.ReadAllBytesAsync(String, CancellationToken) 方法

定義

非同步開啟二進位檔案,將檔案內容讀入位元組陣列,然後關閉該檔案。

public static System.Threading.Tasks.Task<byte[]> ReadAllBytesAsync(string path, System.Threading.CancellationToken cancellationToken = default);
static member ReadAllBytesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
Public Shared Function ReadAllBytesAsync (path As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Byte())

參數

path
String

檔案要打開以供閱讀。

cancellationToken
CancellationToken

用來監控取消申請的代幣。 預設值為 None

傳回

Task<Byte[]>

一個代表非同步讀取操作的任務,將包含檔案內容的位元組陣列包裝起來。

例外狀況

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外,該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外,該例外會在等待任務時拋出。 使用例外錯誤,例如 ArgumentException,仍會同步拋出。 關於儲存的例外,請參見由 ReadAllBytes(String)拋出的例外。

適用於