ASP.NET 2.0高级控件之FileUpload控件

应用程序中经常需要允许用户把文件上传到web服务器。尽管在ASP.NET 1.X也可以完成该功能，但在ASP.NET 2.0中使用FileUpload控件会更简单。

　　该控件让用户更容易地浏览和选择用于上传的文件，它包含一个浏览按钮和用于输入文件名的文本框。只要用户在文本框中输入了完全限定的文件名，无论是直接输入或通过浏览按钮选择，都可以调用FileUpload的SaveAs方法保存到磁盘上。

　　除了从WebControl类继承的标准成员，FileUpload控件还公开了几个只读的属性，在表5-8和表5-9列出。

　　表5-8 FileUpload控件属性

名  称 类型 读 写 说  明

FileContent Stream × 返回一个指向上传文件的流对象

FileName string × 返回要上传文件的名称，不包含路径信息

HasFile Boolean × 如果是true，则表示该控件有文件要上传

PostedFile HttpPostedFile × 返回已经上传文件的引用。表5-9列出了它所公开的只读属性

　　表5-9 HttpPostedFile属性

名  称 类  型 读 写 说  明

ContentLength integer × 返回上传文件的按字节表示的文件大小

ContentType string × 返回上传文件的MIME内容类型

FileName string × 返回文件在客户端的完全限定名

InputStream Stream × 返回一个指向上传文件的流对象

　　所有这些属性将在下面的示例中说明。

　　为了查看FileUpload控件在实际中的运用，创建一个FileUploadDemo网站。在页面上添加一个FileUpload控件，然后，添加两个ASP.NET按钮，Text属性分别设置为Save和Display，ID分别设置为btnSave和btnDisplay。增加两个Label控件，并分别将ID设置为lblMesage和lblDisplay。用＜br/＞HTML元素分隔这些控件。切换到设计视图，通过双击每个按钮，为它们在代码隐藏文件中创建具有默认名称的Click事件处理程序。完成后的内容文件类似于示例5-11。

　　示例5-11：FileUploadDemo网站的default.aspx

＜%@ Page Language=”C#” AutoEventWireup=”true” CodeFile=”Default.aspx.cs” Inherits=”_Default” %＞
＜!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.1//EN” “”＞
＜html xmlns=”” ＞
＜head runat=”server”＞
　＜title＞FileUpload Control＜/title＞
＜/head＞

＜body＞
　＜form id=”form1” runat=”server”＞
　＜div＞
　　＜h1＞FileUpload Control＜/h1＞
　　＜asp:FileUpload ID=”FileUpload1” runat=”server” /＞
　　＜br /＞
　　＜asp:Button ID=”btnSave” runat=”server” Text=”Save” OnClick=”btnSave_Click” /＞
　　＜asp:Button ID=”btnDisplay” runat=”server” Text=”Display” OnClick=”btnDisplay_Click” /＞
　　＜br /＞
　　＜br /＞
　　＜asp:Label ID=”lblMessage” runat=”server” /＞
　　＜asp:Label ID=”lblDisplay” runat=”server” /＞
　＜/div＞
　＜/form＞
＜/body＞
＜/html＞

　　在代码隐藏文件中，添加示例5-12中高亮显示的代码，非高亮显示的代码由VS2005自动创建。

　　示例5-12：FileUploadDemo网站的Default.aspx.cs

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using System.IO; // 使用Stream必需

public partial class _Default : System.Web.UI.Page
{
　protected void Page_Load(object sender, EventArgs e)
　{}
　protected void btnSave_Click(object sender, EventArgs e)
　{
　　string str = “”;
　　if (FileUpload1.HasFile)
　　{
　　　try
　　　{
　　　　str += “Uploading file: “ + FileUpload1.FileName;
　　　　// 保存文件
　　　　FileUpload1.SaveAs(“c:\websites\uploads\” + FileUpload1.FileName);
　　　　// 显示文件信息
　　　　str += “＜br/＞Saved As: “ + FileUpload1.PostedFile.FileName;
　　　　str += “＜br/＞File Type: “ + FileUpload1.PostedFile.ContentType;
　　　　str += “＜br/＞File Length (bytes): “ + FileUpload1.PostedFile.ContentLength;
　　　　str += “＜br/＞PostedFile File Name: “ + FileUpload1.PostedFile.FileName;
　　　}
　　　catch (Exception ex)
　　　{
　　　　str += “＜br/＞＜b＞Error＜/b＞＜br/＞Unable to save
c:\websites\uploads\” + FileUpload1.FileName +“＜br/＞” + ex.Message;
　　　}
　　}
　　else
　　{
　　　str = “No file uploaded.”;
　　}
　　lblMessage.Text = str;
　　lblDisplay.Text = “”;
　}

　protected void btnDisplay_Click(object sender, EventArgs e)
　{
　　string str = “＜u＞File: “ + FileUpload1.FileName + “＜/u＞＜br/＞”;
　　if (FileUpload1.HasFile)
　　{
　　　try
　　　{
　　　　Stream stream = FileUpload1.FileContent;
　　　　StreamReader reader = new StreamReader(stream);
　　　　string strLine = “”;
　　　　do
　　　　{
　　　　　strLine = reader.ReadLine( );
　　　　　str += strLine;
　　　　} while (strLine != null);
　　　}
　　　catch (Exception ex)
　　　{
　　　　str += “＜br/＞＜b＞Error＜/b＞＜br/＞Unable to display “ + FileUpload1.FileName +
“＜br/＞” + ex.Message;
　　　}
　　}
　　else
　　{
　　　str = “No file uploaded.”;
　　}
　　lblDisplay.Text = str;
　　lblMessage.Text = “”;
　}
}

　　高亮显示的using声明对于不使用完全限定命名空间，而使用Stream对象是必须的。

　　在Save按钮的btnSave_Click事件处理程序中，FileUpload控件的HasFile属性用于检测文本框中是否输入了有效的完全限定文件名。如果文本框为空或输入的名称无效，将不会通过检测，并且lblMessage将显示“No file upladed”。

　　假定上传了一个有效文件，那么将执行try代码块中的代码。关键语句是调用File- Upload控件的SaveAs方法。该方法使用硬编码路径和FileName属性传递一个完全限定的文件名。该语句可能会由于各种原因而失败，包括磁盘空间不足、无效的路径或安全问题（稍后会有更详细的说明）。

　　如果SaveAs方法失败，则执行catch代码块。在lblMessage中显示一个错误信息，包括该异常的Message属性ex.Message。

　　如果SaveAs方法执行成功，关于上传文件的多个信息将显示在lblMessage中，这些信息通过FileUpload.PostedFile（类型为HttpPostedFile）中的属性获取。

　　Display按钮的Click事件处理程序与前面的类似，只不过它不是显示文件信息，而是显示文件内容。它通过使用FileContent属性获取表现为Stream对象的上传文件的内容，然后这个Stream对象被用于实例化一个StreamReader对象。StreamReader的Read- Line方法逐行的遍历文件，然后把合并后的字符串显示在lblDisplay中。

　　当在讨论从客户端上传文件到web服务器时，安全是非常让人关注的。须注意两点，首先，使用这种方式会公开web服务器，从而会有非常大的安全漏洞，为此要特别细心。因为这样不仅可以上传病毒，木马和其他恶意软件，还会存在客户端浏览web服务器目

　　录结构的危险。因此，应该使用硬编码目标目录，至少严格限定在哪里保存上传的文件。

　　另外，要注意的一点是，允许在磁盘写文件所必需的权限。在开发web应用程序时，一般情况下，开发机器同时也是web服务器，特别是使用VS2005默认的开发模式。在该模式下使用的是内置的web服务器，并且不通过IIS访问网站而是由文件系统访问网站。这样，永远也不会有权限问题。

　　然而，当网站部署到产品服务器上，且该网站通过IIS和虚拟目录来访问时，就会出现问题。这是因为运行ASP.NET的账户必须拥有对用于保存上传文件的目录的写权限。在Windows2000/XP中，账户的名称是ASPNET。在Windows Server2003中，写权限必须分配给IIS_WPG账户组。

　　利用FileUpload控件并结合良好的安全防护，用户可以把自己的文件传送到网站，以丰富网站功能。