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)

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

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

Комментарии

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

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

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

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.ReadAllText метод.

Кому	Смотри
Чтение из текстового файла	How to: Read From Text Files in 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)

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

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

Комментарии

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

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

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

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.ReadAllText метод.

Кому	Смотри
Чтение из текстового файла	How to: Read From Text Files in Visual Basic

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

• Encoding
• StreamReader(Stream, Encoding)