My.Computer.FileSystem.ReadAllText 方法

更新：2007 年 11 月

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

' Usage
Dim value As String = My.Computer.FileSystem.ReadAllText(file)
Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding)
' Declaration
Public Function ReadAllText( _
   ByVal file As String _
) As String
' -or-
Public Function ReadAllText( _
   ByVal file As String, _
   ByVal encoding As System.Text.Encoding _
) As String

参数

• file
  String。要读取的文件的文件名和路径。必选。

• encoding
  System.Text.Encoding。读取文件时使用的字符编码。必选。默认为 UTF-8。

返回值

String 包含文件的内容。

异常

文件的内容可能不是预期内容，并且用来读取该文件的方法可能失败。

以下情况可能会导致异常：

• 路径由于以下原因之一而无效：它是零长度字符串；它仅包含空白；它包含无效字符；或者它是一个设备路径（以 \\.\ 开头）(ArgumentException)。

• 文件名结尾带一个斜杠 (ArgumentException)。

• 路径无效，因为它是 Nothing (ArgumentNullException)。

• 该文件不存在 (FileNotFoundException)。

• 该文件正由其他进程使用，或发生 I/O 错误 (IOException)。

• 路径超过了系统定义的最大长度 (PathTooLongException)。

• 路径中的文件名或目录名包含冒号 (:)，或格式无效 (NotSupportedException)。

• 没有足够的内容将字符串写入缓冲区 (OutOfMemoryException)。

• 该用户缺少查看该路径所必需的权限 (SecurityException)。

备注

My.Computer.FileSystem 对象的 ReadAllText 方法允许读取文本文件。文件内容将作为字符串返回。

如果文件内容采用诸如 ASCII 或 UTF-8 的编码，则可指定文件编码。如果读取的文件包含扩展字符，则需要指定文件编码。

不要根据文件的名称来判断文件的内容。例如，Form1.vb 文件可能不是 Visual Basic 源文件。在应用程序中使用输入的数据之前，需验证所有的输入内容。

任务

下表列出了涉及 My.Computer.FileSystem.ReadAllText 方法的任务示例。

示例

此示例将 Test.txt 的内容读入字符串，然后在消息框中显示内容。

Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

此示例将 ASCII 文件 Test.txt 的内容读入字符串，然后在消息框中显示内容。

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

要求

命名空间：Microsoft.VisualBasic.MyServices

类：FileSystemProxy（提供对 FileSystem 的访问）

**程序集：**Visual Basic Runtime Library（位于 Microsoft.VisualBasic.dll 中）

按项目类型列出可用性

权限

以下权限可能是必需的：

有关更多信息，请参见代码访问安全性和请求权限。

请参见

任务

如何：使用 StreamReader 读取文件中的文本 (Visual Basic)

疑难解答：读取和写入文本文件

演练：在 Visual Basic 中操作文件和目录

概念

文件编码

参考

My.Computer.FileSystem 对象

System.Text.Encoding

FileSystem.ReadAllText

StreamReader

其他资源

读取文件 (Visual Basic)