Поделиться через


FileSystemProxy.ReadAllText Метод

Определение

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

Перегрузки

ReadAllText(String)

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

ReadAllText(String, Encoding)

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

ReadAllText(String)

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

public:
 System::String ^ ReadAllText(System::String ^ file);
public string ReadAllText (string file);
member this.ReadAllText : string -> string
Public 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 .

Кому См.
Чтение из текстового файла Практическое руководство. Чтение из текстовых файлов

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

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

ReadAllText(String, Encoding)

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

public:
 System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);
public string ReadAllText (string file, System.Text.Encoding encoding);
member this.ReadAllText : string * System.Text.Encoding -> string
Public 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 .

Кому См.
Чтение из текстового файла Практическое руководство. Чтение из текстовых файлов

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

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