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

定义

命名空间:

Microsoft.VisualBasic.FileIO

程序集:

Microsoft.VisualBasic.Core.dll

Source:

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 中写入二进制文件