当前位置：首页 > ASP.NET 2.0高级控件之FileUpload控件

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

点击次数:885  更新日期:2010-12-28
\n

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

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

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

　　表5-8 FileUpload控件属性


\n

\n


\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
名 称 类型 读 写 说 明
FileContent Stream × 返回一个指向上传文件的流对象
FileName string × 返回要上传文件的名称，不包含路径信息
HasFile Boolean × 如果是true，则表示该控件有文件要上传
PostedFile HttpPostedFile × 返回已经上传文件的引用。表5-9列出了它所公开的只读属性

　　表5-9 HttpPostedFile属性


\n

\n


\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
名 称 类 型 读 写 说 明
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


\n

\n


\n
＜%@ 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


\n

\n


\n
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控件并结合良好的安全防护，用户可以把自己的文件传送到网站，以丰富网站功能。

来源:天极

\n