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

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

來源:

FileSystem.vb

將資料寫入二進位檔案。

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。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。

ArgumentNullException

file 為 Nothing。

FileNotFoundException

檔案不存在。

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

沒有足夠的記憶體可將字串寫入緩衝區。

SecurityException

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

範例

這個範例會將數據陣列 CustomerData 附加至檔案 CollectedData。

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

備註

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

注意

方法 WriteAllBytes 會開啟檔案、寫入檔案，然後關閉檔案。 使用方法的程式 WriteAllBytes 代碼比使用 BinaryWriter 物件的程式代碼更簡單。 不過，如果您要使用迴圈將數據新增至檔案，物件可以提供更佳的效能， BinaryWriter 因為您只需要開啟並關閉檔案一次。

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

收件者	請參閱
寫入至二進位檔案	如何：在 Visual Basic 中寫入二進位檔案