应用程序中经常需要允许用户把文件上传到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” “http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd”＞ ＜html xmlns=”http://www.w3.org/1999/xhtml” ＞ ＜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控件并结合良好的安全防护，用户可以把自己的文件传送到网站，以丰富网站功能。