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 , возникнет исключение. Если путь является допустимым, но файл не существует, создается файл.

Примечание

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

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

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