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

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

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualBasic.MyServices
Сборка:
Microsoft.VisualBasic.dll
Сборка:
Microsoft.VisualBasic.Forms.dll

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

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.

Исключения

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 метод .

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

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

См. также раздел