共用方式為


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

定義

將資料寫入二進位檔案。

public:
 void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);
public void WriteAllBytes (string file, byte[] data, bool append);
member this.WriteAllBytes : string * byte[] * bool -> unit
Public 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 方法的工作範例。

收件者 請參閱
寫入至二進位檔案 作法:寫入二進位檔案

適用於

另請參閱