FileSystem.WriteAllBytes(String, Byte[], Boolean) 方法

定義

將資料寫入二進位檔案。

public:
 static void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);
public static void WriteAllBytes(string file, byte[] data, bool append);
static member WriteAllBytes : string * byte[] * bool -> unit
Public Shared Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)

參數

file
String

要寫入檔案的路徑與名稱。

data
Byte[]

要寫入檔案的資料。

append
Boolean

True 附加到檔案內容; False 以覆蓋檔案內容。 預設值為 False

例外狀況

該路徑不成立,原因之一是:它是零長度字串;它僅包含空白;它包含無效字元;或是裝置路徑(以 \\.\ 開頭);結尾是拖尾的斜線。

fileNothing

檔案不存在。

該檔案被其他程序使用,或發生 I/O 錯誤。

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

路徑中的檔案或目錄名稱包含冒號(:),或格式無效。

記憶體不足以將字串寫入緩衝區。

使用者缺乏必要的權限來查看路徑。

範例

此範例將資料陣列 CustomerData 附加到檔案 CollectedData

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

備註

若指定的路徑(不含檔名)無效, DirectoryNotFoundException 則會拋出例外。 如果路徑有效但檔案不存在,則該檔案會被建立。

備註

WriteAllBytes 方法會打開一個檔案,寫入後再關閉它。 使用該 WriteAllBytes 方法的程式碼比使用 BinaryWriter 物件的程式碼簡單。 不過,如果你是用迴圈方式將資料加入檔案,物件 BinaryWriter 的效能會更好,因為你只需要開啟和關閉檔案一次。

下表列出一個涉及此 My.Computer.FileSystem.WriteAllBytes 方法的任務範例。

看!
寫入二進位檔 如何:在 Visual Basic

適用於