FileSystem.WriteAllBytes(String, Byte[], Boolean) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將資料寫入二進位檔案。
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。
例外狀況
該路徑不成立,原因之一是:它是零長度字串;它僅包含空白;它包含無效字元;或是裝置路徑(以 \\.\ 開頭);結尾是拖尾的斜線。
file 是 Nothing。
檔案不存在。
該檔案被其他程序使用,或發生 I/O 錯誤。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱包含冒號(:),或格式無效。
記憶體不足以將字串寫入緩衝區。
使用者缺乏必要的權限來查看路徑。
範例
此範例將資料陣列 CustomerData 附加到檔案 CollectedData。
My.Computer.FileSystem.WriteAllBytes(
"C:\MyDocuments\CustomerData", CustomerData, True)
備註
若指定的路徑(不含檔名)無效, DirectoryNotFoundException 則會拋出例外。 如果路徑有效但檔案不存在,則該檔案會被建立。
備註
該 WriteAllBytes 方法會打開一個檔案,寫入後再關閉它。 使用該 WriteAllBytes 方法的程式碼比使用 BinaryWriter 物件的程式碼簡單。 不過,如果你是用迴圈方式將資料加入檔案,物件 BinaryWriter 的效能會更好,因為你只需要開啟和關閉檔案一次。
下表列出一個涉及此 My.Computer.FileSystem.WriteAllBytes 方法的任務範例。
| 至 | 看! |
|---|---|
| 寫入二進位檔 |