FileSystem.ReadAllText Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает содержимое текстового файла как String.
Перегрузки
| ReadAllText(String) |
Возвращает содержимое текстового файла как |
| ReadAllText(String, Encoding) |
Возвращает содержимое текстового файла как |
ReadAllText(String)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
Возвращает содержимое текстового файла как String.
public:
static System::String ^ ReadAllText(System::String ^ file);public static string ReadAllText (string file);static member ReadAllText : string -> stringPublic Shared Function ReadAllText (file As String) As StringПараметры
- file
- String
Имя файла и путь к файлу, чтение которого необходимо выполнить.
Возвращаемое значение
String с содержимым файла.
Исключения
Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\); заканчивается косой чертой в конце.
file имеет значение Nothing.
Файл не существует.
Файл уже используется другим процессом или возникла ошибка ввода-вывода.
Длина пути превышает максимальную длину, определенную в системе.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
Не хватает памяти для записи строки в буфер.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Примеры
В этом примере содержимое Test.txt считывается в строку, а затем отображается в окне сообщения.
Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)
В этом примере содержимое ASCII-файла Test.txt считывается в строку, а затем отображается в окне сообщения.
Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
System.Text.Encoding.ASCII)
MsgBox(reader)
Комментарии
Метод ReadAllText объекта My.Computer.FileSystem позволяет считывать данные из текстового файла. Содержимое файла возвращается в виде строки.
Кодировку файла можно указать, если содержимое файла хранится в кодировке, такой как ASCII или UTF-8. При чтении из файла с расширенными символами необходимо указать кодировку файла с помощью другой перегрузки ReadAllText метода .
По имени файла не всегда можно с уверенностью судить о его содержимом. Например, файл с именем Form1.vb может вовсе не быть исходным файлом Visual Basic. Следует проверять все входные данные перед использованием их в приложении.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.ReadAllText метод .
| Кому | См. |
|---|---|
| Чтение из текстового файла | Практическое руководство. Чтение из текстовых файлов в Visual Basic |
См. также раздел
Применяется к
ReadAllText(String, Encoding)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
Возвращает содержимое текстового файла как String.
public:
static System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);public static string ReadAllText (string file, System.Text.Encoding encoding);static member ReadAllText : string * System.Text.Encoding -> stringPublic Shared Function ReadAllText (file As String, encoding As Encoding) As StringПараметры
- file
- String
Имя файла и путь к файлу, чтение которого необходимо выполнить.
- encoding
- Encoding
Кодировка, которую необходимо использовать при чтении файла. По умолчанию — UTF-8.
Возвращаемое значение
String с содержимым файла.
Исключения
Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\); заканчивается косой чертой в конце.
file имеет значение Nothing.
Файл не существует.
Файл уже используется другим процессом или возникла ошибка ввода-вывода.
Длина пути превышает максимальную длину, определенную в системе.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
Не хватает памяти для записи строки в буфер.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Примеры
В этом примере содержимое Test.txt считывается в строку, а затем отображается в окне сообщения.
Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)
В этом примере содержимое ASCII-файла Test.txt считывается в строку, а затем отображается в окне сообщения.
Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
System.Text.Encoding.ASCII)
MsgBox(reader)
Комментарии
Метод ReadAllText объекта My.Computer.FileSystem позволяет считывать данные из текстового файла. Содержимое файла возвращается в виде строки.
Кодировку файла можно указать, если содержимое файла хранится в кодировке, такой как ASCII или UTF-8. При чтении из файла с расширенными символами необходимо указать кодировку файла.
По имени файла не всегда можно с уверенностью судить о его содержимом. Например, файл с именем Form1.vb может вовсе не быть исходным файлом Visual Basic. Следует проверять все входные данные перед использованием их в приложении.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.ReadAllText метод .
| Кому | См. |
|---|---|
| Чтение из текстового файла | Практическое руководство. Чтение из текстовых файлов в Visual Basic |
