Поделиться через


FileSystem.WriteAllBytes(String, Byte[], Boolean) Метод

Определение

Записывает данные в двоичный файл.

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.

Исключения

Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\); заканчивается косой чертой в конце.

file имеет значение Nothing.

Файл не существует.

Файл уже используется другим процессом или возникла ошибка ввода-вывода.

Длина пути превышает максимальную длину, определенную в системе.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

Не хватает памяти для записи строки в буфер.

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В этом примере массив CustomerData данных добавляется в файл CollectedData.

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

Комментарии

Если указанный путь, за исключением имени файла, недопустим DirectoryNotFoundException , возникнет исключение. Если путь является допустимым, но файл не существует, создается файл.

Примечание

Метод WriteAllBytes открывает файл, записывает в него и закрывает его. Код, использующий WriteAllBytes метод , проще, чем код, использующий BinaryWriter объект . Однако при добавлении данных в файл с помощью цикла объект может обеспечить более высокую производительность, BinaryWriter так как файл нужно открыть и закрыть только один раз.

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.WriteAllBytes метод .

Кому См.
Запись в двоичный файл Практическое руководство. Запись текста в двоичные файлы в Visual Basic

Применяется к