File.ReadAllBytes(String) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

File.cs

開啟二進位檔案，將檔案內容讀入位元組陣列，然後關閉檔案。

public:
 static cli::array <System::Byte> ^ ReadAllBytes(System::String ^ path);

public static byte[] ReadAllBytes (string path);

static member ReadAllBytes : string -> byte[]

Public Shared Function ReadAllBytes (path As String) As Byte()

參數

path

String

要開啟用於讀取的檔案。

傳回

Byte[]

包含檔案內容的位元組陣列。

例外狀況

ArgumentException

.NET Framework和 2.1 之前的 .NET Core 版本： path 是長度為零的字串、只包含空白字元，或包含一或多個無效字元。 您可以使用 GetInvalidPathChars() 方法查詢無效字元。

ArgumentNullException

path 為 null。

PathTooLongException

指定的路徑、檔案名稱，或兩者都超出系統定義的長度上限。

DirectoryNotFoundException

指定的路徑無效 (例如，它位於未對應的磁碟機上)。

IOException

開啟檔案時發生 I/O 錯誤。

UnauthorizedAccessException

這個作業在目前平台不受支援。

-或-

path 指定了目錄。

-或-

呼叫端沒有必要的權限。

FileNotFoundException

找不到 path 指定的檔案。

NotSupportedException

path 格式無效。

SecurityException

呼叫端沒有必要的權限。

備註

指定檔案路徑時，這個方法會開啟檔案、將檔案的內容讀入位元組陣列，然後關閉檔案。

另請參閱

• 檔案和資料流程 I/O
• 從檔案讀取文字
• 作法：將文字寫入檔案
• 作法：讀取和寫入新建立的資料檔案