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

Определение

Пространство имен:

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

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

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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

Примеры

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

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

Комментарии

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

Note

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

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

Кому	Смотри
Запись в двоичный файл	How to: Write to: Write to Binary Files in Visual Basic