My.Computer.FileSystem.WriteAllBytes 方法

更新：2007 年 11 月

將資料寫入二進位檔中。

' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
   ByVal file As String, _
   ByVal data As Byte(), _
   ByVal append As Boolean _
)

參數

• file
  String。要寫入之檔案的路徑和名稱。必要項。

• data
  Byte。要寫入檔案的資料。必要項。

• append
  Boolean。是否附加或覆寫資料。預設值為 False。必要項。

例外狀況

下列情況可能會導致例外狀況：

• 因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元，或者它是裝置路徑 (開頭為 \\.\) (ArgumentException)。

• 由於路徑是 Nothing 或是以反斜線 (\) (ArgumentNullException) 結束，所以無效。

• file 參數會指向不存在的路徑 (FileNotFoundException 或 DirectoryNotFoundException)。

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

• 路徑超過系統定義的最大長度 (PathTooLongException)。

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

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

備註

如果 append 參數為 True，它會將資料附加到檔案，否則會覆寫檔案中的資料。

如果指定的路徑 (不含檔案名稱) 無效，將會擲回 DirectoryNotFoundException 例外狀況。如果路徑有效，但檔案不存在，則會建立檔案。

注意事項：
WriteAllBytes 方法會開啟檔案並寫入檔案，然後關閉檔案。使用 WriteAllBytes 方法的程式碼比使用 BinaryWriter 物件的程式碼更簡單。不過，若要使用迴圈將資料加入至檔案，BinaryWriter 物件會提供更好的效能，因為只需開啟及關閉檔案一次。

工作

下表列出包含 My.Computer.FileSystem.WriteAllBytes 方法的工作範例。

若要	請參閱
寫入二進位檔	HOW TO：在 Visual Basic 中寫入二進位檔案

範例

這個範例會將資料陣列 CustomerData 加入至檔案 CollectedData。

My.Computer.FileSystem.WriteAllBytes _
("C:\MyDocuments\CustomerData", CustomerData, True)

需求

命名空間：Microsoft.VisualBasic.MyServices

類別：FileSystemProxy (提供對 FileSystem 的存取)

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	可以
類別庫	可以
主控台應用程式	可以
Windows 控制項程式庫	可以
Web 控制項程式庫	可以
Windows 服務	可以
網站	可以

使用權限

下列使用權限可能為必要：

使用權限	描述
FileIOPermission	控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。

如需詳細資訊，請參閱程式碼存取安全性和要求使用權限。

請參閱

工作

HOW TO：在 Visual Basic 中寫入二進位檔案

參考

My.Computer.FileSystem 物件

WriteAllBytes

其他資源

在 Visual Basic 中寫入檔案