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 中)
按项目类型列出可用性
项目类型 |
可用 |
---|---|
Windows 应用程序 |
是 |
类库 |
是 |
控制台应用程序 |
是 |
Windows 控件库 |
是 |
Web 控件库 |
是 |
Windows 服务 |
是 |
网站 |
是 |
权限
以下权限可能是必需的:
权限 |
说明 |
---|---|
控制访问文件和文件夹的能力。关联的枚举:Unrestricted。 |
请参见
任务
如何:使用 StreamReader 读取文件中的文本 (Visual Basic)