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

功能 查看
写入二进制文件 如何:写入二进制文件

适用于

另请参阅