Метод My.Computer.FileSystem.WriteAllBytes
Обновлен: Ноябрь 2007
Записывает данные в двоичный файл.
' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
ByVal file As String, _
ByVal data As Byte(), _
ByVal append As Boolean _
)
Параметры
file
String. Имя файла, в который необходимо выполнить запись, и путь к нему. Обязателен.data
Byte. Данные, которые необходимо записать в файл. Обязательно.append
Boolean. Указывает, следует ли добавить данные или же перезаписать их. По умолчанию используется значение False. Обязательно.
Исключения
Исключение может возникнуть при следующих условиях:
Путь является недопустимым по одной из следующих причин: это строка нулевой длины; она содержит только пробелы; она содержит недопустимые знаки; это путь устройства (начинается с \\.\) (ArgumentException).
Путь является недопустимым, поскольку он является Nothing или заканчивается обратной косой чертой (\) (ArgumentNullException).
Параметр file указывает на путь, который не существует (FileNotFoundException или DirectoryNotFoundException).
Файл уже используется другим процессом или возникла ошибка ввода-вывода (IOException).
Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).
У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).
Заметки
Если параметр append имеет значение True, то данные будут добавляться в конец файла; в противном случае данные в файле перезаписываются.
Если указанный путь без имени файла недопустим, возникнет исключение DirectoryNotFoundException. Если путь является допустимым, но файл не существует, файл будет создан.
.gif "Примечание") Примечание. |
|---|
Метод WriteAllBytes открывает файл, записывает в него данные и закрывает его. Код, использующий метод WriteAllBytes, проще, чем код, использующий объект BinaryWriter. Однако, при добавлении данных в файл с помощью цикла, объект BinaryWriter может обеспечить более высокую производительность, поскольку необходимо лишь один раз открыть и закрыть файл. |
Задачи
В следующей таблице содержится пример задачи, в которой используется метод My.Computer.FileSystem.WriteAllBytes.
To |
См. в разделе |
|---|---|
Запись в двоичный файл |
Практическое руководство. Запись текста в двоичные файлы в Visual Basic |
Пример
Этот пример добавляет массив данных CustomerData в файл CollectedData.
My.Computer.FileSystem.WriteAllBytes _
("C:\MyDocuments\CustomerData", CustomerData, True)
Требования
Пространство имен:Microsoft.VisualBasic.MyServices
Класс:FileSystemProxy (предоставляет доступ к FileSystem)
Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)
Доступность по типу проекта
Тип проекта |
Доступность |
|---|---|
Приложение Windows |
Да |
Библиотека классов |
Да |
Консольное приложение |
Да |
Библиотека элементов управления Windows |
Да |
Библиотека веб-элементов управления |
Да |
Служба Windows |
Да |
Веб-узел |
Да |
Разрешения
Могут потребоваться следующие разрешения:
Разрешение |
Описание |
|---|---|
Определяет возможность доступа к файлам и папкам. Связанное перечисление: Unrestricted. |
Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.
См. также
Задачи
Практическое руководство. Запись текста в двоичные файлы в Visual Basic