FileSystem.ReadAllText 方法

定义

命名空间:

Microsoft.VisualBasic.FileIO

程序集:

Microsoft.VisualBasic.Core.dll

将文本文件的内容作为 String 返回。

重载

ReadAllText(String)	将文本文件的内容作为 String 返回。
ReadAllText(String, Encoding)	将文本文件的内容作为 String 返回。

ReadAllText(String)

Source:

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

文件正由另一个进程使用，或者出现 I/O 错误。

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)

Source:

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

文件正由另一个进程使用，或者出现 I/O 错误。

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)