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

例外

路径无效,原因如下:它是零长度字符串;它仅包含空格;它包含无效字符;或者它是以 \\.\) 开头 (设备路径;它以尾部斜杠结尾。

fileNothing

文件不存在。

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

路径超过了系统定义的最大长度。

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

内存不足,无法将字符串写入缓冲区。

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

示例

此示例将 的内容 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

例外

路径无效,原因如下:它是零长度字符串;它仅包含空格;它包含无效字符;或者它是以 \\.\) 开头 (设备路径;它以尾部斜杠结尾。

fileNothing

文件不存在。

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

路径超过了系统定义的最大长度。

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

内存不足,无法将字符串写入缓冲区。

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

示例

此示例将 的内容 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 方法的任务示例。

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

另请参阅

适用于