在ASP.NET页中读取文本文件

简介
在现实世界中，人们经常希望能够把某个文本文件的部分或全部内容保存到一个 Web 网页变量中。在经典的 ASP 中，只要简单地使用 FileSystemObject 就能做到了。其实，在 ASPFAQs.com 中就有一个 FAQ 栏目专门讨论 FileSystemObject 。
可是在 ASP.NET 中呢？FileSystemObject 当然还可以用，不过，经验表明这么做会严重影响服务器性能。因此，最好还是使用 .NET 框架本身提供的类来读取文件。本文要介绍的是如何读取文本文件；今后我还会介绍如何使用 .NET 框架类来读取 XML 文件。

File ？ FileInfo ？

在 .NET 框架中，有许多方法可以打开文本文件。有趣的是，所有这么方法集中在 System.IO 名字空间的两个类中。它们是 File 类和 FileInfo 类。两个类之间的区别很小。File 类的方法全都是共享方法(静态方法)，而FileInfo 类有例外。共享方法就是不用创建类实例也能调用的方法。假设要用这两个类删除文件，则可以这么做：

'使用 File 类
File.Delete(fileName)

'使用 FileInfo 类
Dim fInfo as FileInfo
fInfo = new FileInfo(fileName)
fInfo.Delete()

请注意，File 类的 Delete 方法只带一个参数，即待删的文件，而且不必对 File 类进行实例化就能调用。再来看 FileInfo 类，它的 Delete 方法不带参数，因为文件名在 FileInfo 类实例的构造器中指定。

就我个人而言，我偏爱 File ，因此就拿它来作示范吧。我敢打赌 File 类的效率稍微高那么一点点，因为使用它就不会因为类的实例化而烦恼；不过那只是猜测而已。(如果感兴趣，请不妨编程比较一下它们的性能。当你完成之后，请把结果告诉我！)

打开文件

打开文本文件最简单的途径是调用 OpenText 方法，它将按照 UTF-8 (ASCII) 格式打开文本文件。你还可以选择通用的 Open 方法，以便指定文件操作模式 (create/open/append/truncate) 、操作权限 (read/write/read-write) 和文件共享权限了；可既然你只需要读取文本文件，那么相对简单的 OpenText 方法也就足以应付了。
OpenText 方法返回一个 StreamReader 对象，只要访问该对象就能从刚才打开的文件中读取文本内容。因此，打开文件所用的 ASP.NET 代码大致如下：

<%@ Import Namespace="System.IO" %>
<script language="vb" runat="server">
sub Page_Load(sender as Object, e as EventArgs)
'以“只读”方式打开文件
Dim FILENAME as String = Server.MapPath("Rand.txt")

'创建 StreamReader 类实例，准备读取文件内容
Dim objStreamReader as StreamReader
objStreamReader = File.OpenText(FILENAME)
...

请注意，代码的第一行导入了 System.IO 命名空间。这是因为 File 类就属于此命名空间。还有，在 Page_Load 事件处理程序中，创建了一个字符串 FILENAME ，其内容就是欲打开的文件的物理路径(比如 C:/Inetpub/wwwroot/Rand.txt)。最后，在 ASP.NET 中的 Server.MapPath 也和经典的 ASP 中相同 (为了更好地理解 Server.MapPath ，请别忘了阅读位于 http://aspnet.4guysfromrolla.com/webtech/121799-1.shtml 的《Using Server.MapPath》)。

从文件中读取文本

现在，你面临两种选择：(1) 读取文件当前位置的下一行文本到字符串；(2) 读取整个文件的文本到字符串。如果是后者，你只需调用 ReadToEnd() 方法即可：
...
'现在，读取整个文件的文本到字符串
Dim contents as String = objStreamReader.ReadToEnd()
...

但如果是前者呢？在读取下一行文本之前，须得先确认尚有文本可读。为此，可以尝试 Peek() 方法。Peek() 方法能够返回指定流的下一个文本字符，却不把该字符从流中删掉；如果流中不再有文本字符可读，则返回 -1。接下来，只要循环遍历 Peek() 的返回值：loop while objStreamReader.Peek() <> -1 ，并且在循环内部使用 ReadLine() 方法读取下一行文本就行了：

While objStreamReader.Peek() <> -1
someString = objStreamReader.ReadLine()
'... do whatever else you need to do ...
End While

切记！关闭 StreamReader 对象！

当你读完全部文本，并且不再操作此文件时，千万记住要使用 Close() 方法关闭 StreamReader 对象，以关闭此文件。如果你忘记这么做，则 ASP.NET 操作进程将保持对此文件的只读锁定状态，因而当你换用其它帐号操作此文件时将会遇到错误信息 “access denied”(拒绝访问) ；而且当你试图删除或覆盖此文件时也将遇到同样的错误信息；只不过 ASP.NET 本身对此文件的操作却不受影响。因此，一定要在完成操作之后关闭文件。

附：完整的示范程序

<%@ Import Namespace="System.IO" %>
<script language="vb" runat="server">
sub Page_Load(sender as Object, e as EventArgs)
'以只读方式打开一个文件
Dim FILENAME as String = Server.MapPath("Rand.txt")

'实例化一个 StreamReader 对象用于读取文件
Dim objStreamReader as StreamReader
objStreamReader = File.OpenText(FILENAME)

'现在，读入整个文件的文本并保存到一个字符串里
Dim contents as String = objStreamReader.ReadToEnd()

'在一个 Web 控件中显示文本
lblRawOutput.Text = contents

'为了在便于浏览，最好把回车字符替换成 <br>
lblNicerOutput.Text = contents.Replace(vbCrLf, "<br>")

objStreamReader.Close()
end sub
</script>
<b>Raw File Output</b><br />
<asp:label runat="server" id="lblRawOutput" />
<p>
<b>Nicer Output</b><br />
<asp:label runat="server" id="lblNicerOutput" Font-Name="Verdana" />

结论

本文附带了一个示范程序的源代码。该程序简单地打开一个硬编码的(hard-coded)文本文件，然后把其中的所有文本一次性保存到指定字符串里，再把字符串的值显示在服务器端的一个 Web 控件 label 中。
你看，通过 ASP.NET 页面读取文本文件内容实在不难。虽然在语法上和经典 ASP 的 FileSystemObject 对象有些差异，但是学起来真的很容易。为了更好的掌握如何在 ASP.NET 中读写文件，请务必阅读 《ASP.NET: Tips, Tutorials, and Code》一书 (样本见 http://www.4guysfromrolla.com/webtech/chapters/ASPNET2 )!