InputString 函数

更新:2007 年 11 月

返回 String 值,该值包含以 Input 或 Binary 模式打开的文件中的字符。

在文件 I/O 操作中,My 功能具有比 InputString 更高的效率和更好的性能。有关更多信息,请参见 My.Computer.FileSystem 对象

InputString(_
   ByVal FileNumber As Integer, _
   ByVal CharCount As Integer _
) As String

参数

  • FileNumber
    必需。任何有效文件号。

  • CharCount
    必需。任何指定要读取的字符个数的有效数值表达式。

异常

异常类型

错误号

条件

IOException

52

FileNumber 不存在。

ArgumentException

5

CharCount < 0 或 > 214。

如果正在升级使用非结构化错误处理方式的 Visual Basic 6.0 应用程序,请参见“错误号”一列。(您可以根据 Number 属性(Err 对象) 比较错误号。) 然而,如果可能,应当考虑用 Visual Basic 的结构化异常处理概述 替换这种错误控制。

备注

提供 InputString 函数是为了实现向后兼容性,可能会影响性能。对于非旧式应用程序,My.Computer.FileSystem 对象将提供更好的性能。有关更多信息,请参见 使用 Visual Basic 访问文件

用 InputString 函数读取的数据通常由 Print 或 FilePut 写入文件。仅将此函数用于以 Input 或 Binary 模式打开的文件。

与 Input 函数不同,InputString 函数返回它读取的所有字符,包括逗号、回车符、换行符、引号和前导空格等。

对于以 Binary 访问模式打开的文件,如果试图在 EOF 返回 True 之前用 InputString 函数读取整个文件,则会产生错误。在用 InputString 读取二进制文件时,使用 LOF 和 Loc 函数代替 EOF 函数,在使用 EOF 函数时则使用 FileGet。

安全说明:

从文件读取数据时,请不要根据文件扩展名判断文件的内容。例如,名为 Form1.vb 的文件不一定就是 Visual Basic 源文件。

示例

本示例使用 InputString 函数从文件中一次读取一个字符,并将它输出到 Output 窗口。本示例假设 MyFile 是包含几行示例数据的文本文件。

Dim oneChar As String
' Open file.
FileOpen(1,  "MYFILE.TXT", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
' Get one character.
oneChar = (InputString(1, 1))
' Print to the output window.
System.Console.Out.WriteLine(oneChar)
End While
FileClose(1)

智能设备开发人员说明

不支持此函数。

要求

命名空间:Microsoft.VisualBasic

**模块:**FileSystem

**程序集:**Visual Basic 运行库(在 Microsoft.VisualBasic.dll 中)

请参见

任务

如何:在 Visual Basic 中使用 StreamWriter 向文件中写入文本

如何:在 Visual Basic 中向文件内写入文本

参考

Input 函数

其他资源

使用 Visual Basic 访问文件