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

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

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

' Usage
Dim value As String = My.Computer.FileSystem.ReadAllText(file)
Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding)
' Declaration
Public Function ReadAllText( _
   ByVal file As String _
) As String
' -or-
Public Function ReadAllText( _
   ByVal file As String, _
   ByVal encoding As System.Text.Encoding _
) As String

Параметры

• file
  String. Имя файла и путь к файлу, чтение которого необходимо выполнить. Обязательно.

• encoding
  System.Text.Encoding. Кодировка, которую необходимо использовать для чтения файла. Обязательно. Значение по умолчанию — UTF-8.

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

String — содержимое файла.

Исключения

Содержимое файла может отличаться от ожидаемого, поэтому может не удастся прочесть файл с помощью методов чтения.

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

• Путь недопустим по одной из следующих причин: это строка нулевой длины (пустая строка); строка содержит только пробелы; строка содержит недопустимые знаки; это путь устройства (начинается с \\.\) (ArgumentException).

• Имя файла оканчивается концевой косой чертой (ArgumentException).

• Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).

• Файл не существует (FileNotFoundException).

• Файл уже используется другим процессом или ошибка ввода-вывода (IOException).

• Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).

• Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).

• Не хватает памяти для записи строки в буфере (OutOfMemoryException).

• У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).

Заметки

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

Кодировка файла может быть указана, если в файле используется такая кодировка как ASCII или UTF-8. Если выполняется чтение файла, содержащего символы национального алфавита, необходимо указать кодировку файла.

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

Задачи

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

Пример

В этом примере производится чтение файла Test.txt в строку, а затем строка отображается в окне сообщения.

Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

В этом примере происходит чтение файла Test.txt в кодировке ASCII в строку и затем она отображается в окне сообщения.

Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt", _
   System.Text.Encoding.ASCII)
MsgBox(reader)

Требования

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

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

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

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

Разрешения

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

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

Практическое руководство. Чтение текста из файлов с помощью StreamReader (Visual Basic)

Исправление неполадок, связанных с чтением из текстовых файлов и записью в такие файлы

Пошаговое руководство. Операции с файлами и каталогами в Visual Basic

Основные понятия

Кодировки файлов

Ссылки

Объект My.Computer.FileSystem

System.Text.Encoding

FileSystem.ReadAllText

StreamReader

Другие ресурсы

Чтение из файлов в Visual Basic