通过

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

文件正由另一个进程使用，或者出现 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 方法的任务示例。

功能 查看
从文本文件读取 如何：读取文本文件

另请参阅

适用于

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

文件正由另一个进程使用，或者出现 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 方法的任务示例。

功能 查看
从文本文件读取 如何：读取文本文件

另请参阅

适用于