FileSystem.ReadAllText Метод

Определение

Пространство имен:

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

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

Перегрузки

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

ReadAllText(String)

Исходный код:

FileSystem.vb

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

public:
 static System::String ^ ReadAllText(System::String ^ file);

public static string ReadAllText (string file);

static member ReadAllText : string -> string

Public Shared Function ReadAllText (file As String) As String

Параметры

file

String

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

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

String

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

Исключения

ArgumentException

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

ArgumentNullException

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

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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

Примеры

В этом примере содержимое 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

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

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Исходный код:

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 -> string

Public Shared Function ReadAllText (file As String, encoding As Encoding) As String

Параметры

file

String

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

encoding

Encoding

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

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

String

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

Исключения

ArgumentException

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

ArgumentNullException

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

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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

Примеры

В этом примере содержимое 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

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

• Encoding
• StreamReader(Stream, Encoding)