My.Computer.FileSystem.ReadAllBytes 方法
更新：2007 年 11 月
以位元組陣列傳回檔案的內容。
' Usage Dim value As Byte() = My.Computer.FileSystem.ReadAllBytes(file) ' Declaration Public Function ReadAllBytes( _ ByVal file As String _ ) As Byte()
參數
- file
String。要讀取的檔案。必要項。
傳回值
包含檔案內容的 Byte 陣列。
例外狀況
下列條件可能造成擲回例外狀況：
因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元，或者它是裝置路徑 (開頭為 \\.\) (ArgumentException)。
檔案名稱以斜線結束 (ArgumentException)。
路徑無效，因為它是 Nothing (ArgumentNullException)。
檔案不存在 (FileNotFoundException)。
檔案正由另一個程序使用中，或發生 I/O 錯誤 (IOException)。
路徑超過系統定義的最大長度 (PathTooLongException)。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式 (NotSupportedException)。
記憶體不足，無法將字串寫入緩衝區 (OutOfMemoryException)。
使用者缺乏必要的使用權限來檢視路徑 (SecurityException)。
備註
My.Computer.FileSystem 物件的 ReadAllBytes 方法可以讓您從二進位檔案 (Binary File) 讀取。檔案的內容會以位元組陣列傳回。
不要根據檔案名稱來判斷檔案內容。例如，檔案 Form1.vb 可能不是 Visual Basic 原始程式檔。在應用程式中使用這些資料之前，請先驗證所有輸入值。
工作
下表列出包含 My.Computer.FileSystem.ReadAllBytes 方法的工作範例。
若要 |
請參閱 |
|---|---|
從二進位檔案讀取 |
範例
這個範例會讀取檔案 C:/Documents and Settings/selfportrait.jpg.
My.Computer.FileSystem.ReadAllBytes _
("C:/Documents and Settings/selfportrait.jpg")
需求
命名空間：Microsoft.VisualBasic.MyServices
類別：FileSystemProxy (提供對 FileSystem 的存取)
組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)
依專案類型的可用性
專案類型 |
是否可用 |
|---|---|
Windows 應用程式 |
是 |
類別庫 |
是 |
主控台應用程式 |
是 |
Windows 控制項程式庫 |
是 |
Web 控制項程式庫 |
是 |
Windows 服務 |
是 |
網站 |
是 |
使用權限
下列使用權限可能為必要：
使用權限 |
描述 |
|---|---|
控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。 |