My.Computer.FileSystem.WriteAllBytes 方法

更新：2007 年 11 月

将数据写入二进制文件。

' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
   ByVal file As String, _
   ByVal data As Byte(), _
   ByVal append As Boolean _
)

参数

• file
  String。要写入的文件的路径和名称。必需。

• data
  Byte。要写入文件的数据。必需。

• append
  Boolean。是追加还是覆盖数据。默认值为 False。必需。

异常

以下情况可能会导致异常：

• 路径由于以下原因之一而无效：它是零长度字符串；它仅包含空白；它包含无效字符；或者它是一个设备路径（以 \\.\ 开头）(ArgumentException)。

• 由于路径为 Nothing 或以反斜杠 (\) 结尾，因此路径无效 (ArgumentNullException)。

• file 参数指向的路径不存在（FileNotFoundException 或 DirectoryNotFoundException）。

• 文件正由另一个进程使用，或发生 I/O 错误 (IOException)。

• 路径超过了系统定义的最大长度 (PathTooLongException)。

• 路径中的文件名或目录名包含冒号 (:)，或格式无效 (NotSupportedException)。

• 该用户缺少查看该路径所必需的权限 (SecurityException)。

备注

如果 append 参数为 True，则它会将数据追加到文件；否则将会覆盖文件中的数据。

如果指定的路径（不包括文件名）无效，则会引发 DirectoryNotFoundException 异常。如果路径有效但文件不存在，则会创建文件。

说明：
WriteAllBytes 方法将打开一个文件，向其写入内容，然后将其关闭。使用 WriteAllBytes 方法的代码比使用 BinaryWriter 对象的代码更加简单。但是，如果您使用循环将数据添加到文件中，则 BinaryWriter 对象能够提供更优异的性能，因为您只需打开和关闭该文件一次。

任务

下表列出了涉及 My.Computer.FileSystem.WriteAllBytes 方法的任务的示例。

示例

此示例将数据数组 CustomerData 追加到文件 CollectedData。

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

要求

命名空间：Microsoft.VisualBasic.MyServices

类：FileSystemProxy（提供对 FileSystem 的访问）

**程序集：**Visual Basic 运行时库（位于 Microsoft.VisualBasic.dll 中）

各项目类型的可用性

权限

可能需要下列权限。

有关更多信息，请参见代码访问安全性和请求权限。

请参见

任务

如何：在 Visual Basic 中写入二进制文件

参考

My.Computer.FileSystem 对象

WriteAllBytes

其他资源

写入文件 (Visual Basic)