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

Ссылка

Определение

Пространство имен:: Microsoft.VisualBasic.FileIO

Сборка:: Microsoft.VisualBasic.Core.dll

Сборка:: Microsoft.VisualBasic.dll

Исходный код:: FileSystem.vb

Исходный код:: FileSystem.vb

Исходный код:: 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

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

Продукт	Версии
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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