Метод 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.
To |
См. раздел |
|---|---|
Чтение из текстового файла |
Практическое руководство. Чтение из текстового файла в Visual Basic |
Пример
В этом примере производится чтение файла 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)
Доступность по типу проекта
Тип проекта |
Доступно |
|---|---|
Приложение Windows |
Да |
Библиотека классов |
Да |
Консольное приложение |
Да |
Библиотека элементов управления Windows |
Да |
Библиотека веб-элементов управления |
Да |
Служба Windows |
Да |
Веб-узел |
Да |
Разрешения
Могут потребоваться следующие разрешения:
Разрешение |
Описание |
|---|---|
Определяет возможность доступа к файлам и папкам. Связанное перечисление: Unrestricted. |
Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.
См. также
Задачи
Практическое руководство. Чтение текста из файлов с помощью StreamReader (Visual Basic)
Исправление неполадок, связанных с чтением из текстовых файлов и записью в такие файлы
Пошаговое руководство. Операции с файлами и каталогами в Visual Basic