ASP.NET - 文件上传

ASP.NET 有两个控件允许用户将文件上传到 Web 服务器。 一旦服务器接收到发布的文件数据,应用程序就可以保存它、检查它或忽略它。 以下控件允许文件上传:

  • HtmlInputFile - HTML 服务器控件

  • FileUpload - 和 ASP.NET Web 控件

两个控件都允许文件上传,但 FileUpload 控件会自动设置表单的编码,而 HtmlInputFile 则不会这样做。

在本教程中,我们使用 FileUpload 控件。 FileUpload 控件允许用户浏览并选择要上传的文件,提供浏览按钮和用于输入文件名的文本框。

一旦用户通过键入名称或浏览在文本框中输入了文件名,就可以调用 FileUpload 控件的 SaveAs 方法将文件保存到磁盘。

FileUpload 的基本语法是:

<asp:FileUpload ID= "Uploader" runat = "server" />

FileUpload 类派生自 WebControl 类,并继承了它的所有成员。 除此之外,FileUpload 类还具有以下只读属性:

属性 描述
FileBytes 返回要上传的文件中的字节数组。
FileContent 返回指向待上传文件的流对象。
FileName 返回要上传的文件的名称。
HasFile 指定控件是否有要上传的文件。
PostedFile 返回对上传文件的引用。

发布的文件封装在 HttpPostedFile 类型的对象中,可以通过 FileUpload 类的 PostedFile 属性访问该对象。

HttpPostedFile 类具有以下常用属性:

属性 描述
ContentLength 返回上传文件的大小(以字节为单位)。
ContentType 返回上传文件的MIME类型。
FileName 返回完整的文件名。
InputStream 返回指向上传文件的流对象。

示例

以下示例演示了 FileUpload 控件及其属性。 该表单有一个 FileUpload 控件以及一个保存按钮和一个用于显示文件名、文件类型和文件长度的标签控件。

在设计视图中,表单如下所示:

文件上传

文件代码如下所示:

<body>
   <form id="form1" runat="server">
   
      <div>
         <h3> File Upload:</h3>
         <br />
         <asp:FileUpload ID="FileUpload1" runat="server" />
         <br /><br />
         <asp:Button ID="btnsave" runat="server" onclick="btnsave_Click"  Text="Save" style="width:85px" />
         <br /><br />
         <asp:Label ID="lblmessage" runat="server" />
      </div>
      
   </form>
</body>

保存按钮后的代码如下所示:

protected void btnsave_Click(object sender, EventArgs e)
{
   StringBuilder sb = new StringBuilder();
   
   if (FileUpload1.HasFile)
   {
      try
      {
         sb.AppendFormat(" Uploading file: {0}", FileUpload1.FileName);
         
         //保存文件
         FileUpload1.SaveAs("<c:\\SaveDirectory>" + FileUpload1.FileName);
      
         //显示文件信息
         sb.AppendFormat("<br/> Save As: {0}",  FileUpload1.PostedFile.FileName);
         sb.AppendFormat("<br/> File type: {0}",    FileUpload1.PostedFile.ContentType);
         sb.AppendFormat("<br/> File length: {0}",  FileUpload1.PostedFile.ContentLength);
         sb.AppendFormat("<br/> File name: {0}",  FileUpload1.PostedFile.FileName);
         
      }catch (Exception ex)
      {
         sb.Append("<br/> Error <br/>");
         sb.AppendFormat("Unable to save file <br/> {0}", ex.Message);
      }
   }
   else
   {
      lblmessage.Text = sb.ToString();
   }
}

注意以下几点:

  • StringBuilder类派生自System.IO命名空间,因此需要包含它。

  • try 和 catch 块用于捕获错误,并显示错误消息。