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 方法的任务的示例。

要执行的操作	请参见
写入二进制文件	如何：在 Visual Basic 中写入二进制文件

示例

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

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

要求

命名空间：Microsoft.VisualBasic.MyServices

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

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

各项目类型的可用性

项目类型	是否可用
Windows 应用程序	可用
类库	可用
控制台应用程序	可用
Windows 控件库	可用
Web 控件库	可用
Windows 服务	可用
网站	可用

权限

可能需要下列权限。

权限	说明
FileIOPermission	控制访问文件和文件夹的能力。关联枚举：Unrestricted。

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

请参见

任务

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

参考

My.Computer.FileSystem 对象

WriteAllBytes

其他资源

写入文件 (Visual Basic)