FileSystem.ReadAllBytes(String) 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

來源:

FileSystem.vb

以位元組陣列傳回檔案內容。

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

public static byte[] ReadAllBytes (string file);

static member ReadAllBytes : string -> byte[]

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

參數

file

String

要讀取的檔案。

傳回

Byte[]

Byte 陣列，其中包含檔案內容。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。

ArgumentNullException

file 為 Nothing。

FileNotFoundException

檔案不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

OutOfMemoryException

沒有足夠的記憶體可將字串寫入緩衝區。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

此範例會從檔案讀取 C:/Documents and Settings/selfportrait.jpg.

My.Computer.FileSystem.ReadAllBytes(
  "C:/Documents and Settings/selfportrait.jpg")

備註

物件的 ReadAllBytes 方法 My.Computer.FileSystem 可讓您從二進位檔讀取。 檔案的內容會以位元組陣列的形式傳回。

請勿根據檔案名稱來判斷檔案內容。 例如，檔案 Form1.vb 可能不是 Visual Basic 來源檔案。 在應用程式中使用這些資料之前，請先驗證所有輸入值。

下表列出涉及 My.Computer.FileSystem.ReadAllBytes 方法的工作範例。

收件者	請參閱
讀取二進位檔案	如何：在 Visual Basic 中從二進位檔案讀取