Метод My.Computer.FileSystem.ReadAllBytes

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает содержимое файла в виде массива байтов.

' Usage
Dim value As Byte() = My.Computer.FileSystem.ReadAllBytes(file)
' Declaration
Public Function ReadAllBytes( _
   ByVal file As String _
) As Byte()

Параметры

file
String. Файл для чтения. Обязательный параметр.

Возвращаемое значение

Byte — массив для содержимого файла.

Исключения

Исключение может возникнуть при следующих условиях:

Путь является недопустимым по одной из следующих причин: строка имеет нулевую длину; строка содержит только пробелы; строка содержит недопустимые знаки; строка является путем устройства (начинается с \\.\) (ArgumentException).
Имя файла оканчивается концевой косой чертой (ArgumentException).
Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).
Файл не существует (FileNotFoundException).
Файл уже используется другим процессом или возникла ошибка ввода-вывода (IOException).
Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).
Не хватает памяти для записи строки в буфере (OutOfMemoryException).
Пользователь не имеет необходимых разрешений на просмотр пути (SecurityException).

Заметки

Метод ReadAllBytes объекта My.Computer.FileSystem позволяет считывать из бинарного файла. Содержимое файла возвращается в виде массива байтов.

По имени файла не всегда можно с уверенностью судить о его содержимом. Например файл Form1.vb может не являться исходным файлом Visual Basic. Следует проверять все входные данные перед использованием их в приложении.

Задачи

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

To	См. раздел
Чтение из двоичного файла.	Практическое руководство. Чтение из двоичного файла в Visual Basic

Пример

В этом примере производится считывание из файла C:/Documents and Settings/selfportrait.jpg..

My.Computer.FileSystem.ReadAllBytes _
("C:/Documents and Settings/selfportrait.jpg")

Требования

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

Класс:FileSystemProxy (предоставляет доступ к FileSystem)

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Да
Служба Windows	Да
Веб-узел	Да

Разрешения

Могут потребоваться следующие разрешения:

Разрешение	Описание
FileIOPermission	Определяет возможность доступа к файлам или папкам. Связанное перечисление: Unrestricted.