FileSystem.ReadAllText Метод

Определение

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

Перегрузки

ReadAllText(String)

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

ReadAllText(String, Encoding)

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

ReadAllText(String)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

C#
public static string ReadAllText (string file);

Параметры

file
String

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

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

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

Исключения

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

file имеет значение Nothing.

Файл не существует.

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

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

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

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

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

Примеры

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

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

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

VB
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 метод .

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

ReadAllText(String, Encoding)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

C#
public static string ReadAllText (string file, System.Text.Encoding encoding);

Параметры

file
String

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

encoding
Encoding

Кодировка, которую необходимо использовать при чтении файла. По умолчанию — UTF-8.

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

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

Исключения

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

file имеет значение Nothing.

Файл не существует.

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

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

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

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

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

Примеры

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

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

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

VB
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 метод .

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1