FileSystemProxy.ReadAllText Метод

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualBasic.MyServices
Сборка:
Microsoft.VisualBasic.dll
Сборка:
Microsoft.VisualBasic.Forms.dll

Возвращает содержимое текстового файла как 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

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 .

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

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

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

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

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 .

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

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

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