程式師世界 >> 編程語言 >> .NET網頁編程 >> ASP.NET >> ASP.NET基礎 >> Asp.net實現MVC處理文件的上傳下載功能實例教程

Asp.net實現MVC處理文件的上傳下載功能實例教程

編輯：ASP.NET基礎

上傳於下載功能是程序設計中非常常見的一個功能，在ASP.NET程序開發中有著非常廣泛的應用。本文就以實例形式來實現這一功能。

一、概述

如果你僅僅只有Asp.net Web Forms背景轉而學習Asp.net MVC的，我想你的第一個經歷或許是那些曾經讓你的編程變得愉悅無比的服務端控件都駕鶴西去了.FileUpload就是其中一個，而這個控件的缺席給我們帶來一些小問題。這篇文章主要說如何在Asp.net MVC中上傳文件，然後如何再從服務器中把上傳過的文件下載下來.

二、實現方法

1.文件上傳

在Web Forms中,當你把一個FileUpload控件拖到設計器中，你或許沒有注意到在生成的HTML中會在form標簽中加入一條額外屬性enctype="multipart/form-data". 而FileUpload控件本身會生成為<input type=”file” />，在MVC的view裡，有許多種方法可以做到同樣效果，第一種的HTML如下:

<form action="/" method="post" enctype="multipart/form-data"> 
 <input type="file" name="FileUpload1" /><br /> 
 <input type="submit" name="Submit" id="Submit" value="Upload" /> 
</form>

注意form標簽已經包括了enctype標簽，而method屬性則設為”post”,這樣設置並不多於因為默認的提交時通過HTTP get方式進行的。下面這種方式，使用Html.BeginForm()擴展方法，會生成和上面同樣的HTML：

<% 
 using (Html.BeginForm("", "home", FormMethod.Post, new {enctype="multipart/form-data"}))  
  {%>  
   <input type="file" name="FileUpload1" /><br /> 
   <input type="submit" name="Submit" id="Submit" value="Upload" /> 
<% }%>

注意<input type=”file”>標簽的name屬性，我們在後面再討論
OK,現在我們可以浏覽本地文件然後通過Upload提交按鈕將文件提交到服務器端，下一步就是在服務器端處理上傳的文件，在使用fileUpload控件時，你可以很輕松的通過FileUpload的hasFile方法來查看文件是否被上傳。但是在Asp.net MVC中貌似就不是這麼方便了，你會和原始的HTTP更接近一些，然而，一個擴展方法可以處理這些:

public static bool HasFile(this HttpPostedFileBase file) 
{ 
 return (file != null && file.ContentLength > 0) ? true : false; 
}

當你看到對應的Controller類的代碼時，你會發現Request對象作為HttpRequestBase類型的一個屬性存在。HttpReuqestBase其實是HTTP請求的一個封裝，暴漏了很多屬性，包括Files collection（其實是HttpFileCollectionBase的集合）,在集合中的每一個元素都是HttpPostedFileBase的集合，擴展方法是用於確保上傳的文件是否存在。實際上，這和FileUpload.HasFile()方法的工作原理一致。

在Controller Action中使用起來其實很容易:

public class HomeController : Controller 
{ 
 public ActionResult Index() 
 { 
  foreach (string upload in Request.Files) 
  { 
   if (!Request.Files[upload].HasFile()) continue; 
   string path = AppDomain.CurrentDomain.BaseDirectory + "uploads/"; 
   string filename = Path.GetFileName(Request.Files[upload].FileName); 
   Request.Files[upload].SaveAs(Path.Combine(path, filename)); 
  } 
  return View(); 
 } 
}

2.多文件上傳

或許你已經比我更早的想到如何更好的將Request.Files作為一個集合使用。這意味著它不僅僅只能容納一個文件，而能容納多個，我們將上面的View改為如下：

<% 
 using (Html.BeginForm("", "home", FormMethod.Post, new {enctype="multipart/form-data"}))  
  {%>  
   <input type="file" name="FileUpload1" /><br /> 
   <input type="file" name="FileUpload2" /><br /> 
   <input type="file" name="FileUpload3" /><br /> 
   <input type="file" name="FileUpload4" /><br /> 
   <input type="file" name="FileUpload5" /><br /> 
   <input type="submit" name="Submit" id="Submit" value="Upload" /> 
<% }%>

在Controller的代碼中已經檢查了是否所有的文件上傳框中都有文件，所以即使對於多文件上傳，我們也不再需要修改Controller的代碼，注意每一個<input type=”file”>都有不同的name屬性,如果你需要調用其中一個，比如說，你需要引用第三個輸入框只需要使用:Request.Files["FileUpload3"].

3.存入數據庫

在你沖我狂吼”關注點分離”之前，我想聲明下面的代碼僅僅用於作為說明功能.我將ADO.Net的代碼放入Controller action中，但我們都知道，這並不好。數據訪問的代碼應該放在Model中某個部分的數據訪問層中.但是，下面這段代碼僅僅可以給大家怎樣將上傳的文件存入數據庫中一個更直觀的印象，首先，我們需要創建一個數據表(FileTest)並創建一個表:FileStore

CREATE TABLE [dbo].[FileStore]( 
[ID] [int] IDENTITY(1,1) NOT NULL, 
[FileContent] [image] NOT NULL, 
[MimeType] [nvarchar](50) NOT NULL, 
[FileName] [nvarchar](50) NOT NULL 
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]

FileContent域是image數據類型，用於存儲以二進制數據形成的文件，而Index Action改為：

public ActionResult Index() 
{ 
 foreach (string upload in Request.Files) 
 { 
  if (!Request.Files[upload].HasFile()) continue; 
  string mimeType = Request.Files[upload].ContentType; 
  Stream fileStream = Request.Files[upload].InputStream; 
  string fileName = Path.GetFileName(Request.Files[upload].FileName); 
  int fileLength = Request.Files[upload].ContentLength; 
  byte[] fileData = new byte[fileLength]; 
  fileStream.Read(fileData, 0, fileLength); 
  const string connect = @"Server=.\SQLExpress;Database=FileTest;Trusted_Connection=True;"; 
  using (var conn = new SqlConnection(connect)) 
  { 
   var qry = "INSERT INTO FileStore (FileContent, MimeType, FileName) VALUES (@FileContent, @MimeType, @FileName)"; 
   var cmd = new SqlCommand(qry, conn); 
   cmd.Parameters.AddWithValue("@FileContent", fileData); 
   cmd.Parameters.AddWithValue("@MimeType", mimeType); 
   cmd.Parameters.AddWithValue("@FileName", fileName); 
   conn.Open(); 
   cmd.ExecuteNonQuery(); 
  } 
 } 
 return View(); 
}

修改後的代碼會以循環的方式遍歷Web頁面中所有的上傳文件，並檢查<input type=”file”>中是否已經加入文件，然後，從文件中提取出3個信息：文件名，MIME類型(文件的類型)，HTTP Request中的二進制流。二進制數據被轉換為byte數組，並以image數據類型存入數據庫。MIME類型和文件名對於用戶從數據庫中提取文件來說非常重要。

4.將數據庫中的文件返回給用戶：

你如何將文件傳送給用戶取決於你最開始如何存儲它，如果你將文件存入數據庫，你會用流的方式將文件返還給用戶，如果你將文件存在硬盤中，你只需要提供一個超鏈接即可，或者也可以以流的方式。每當你需要以流的方式將文件送到浏覽器中，你都的使用到File()方法的重載（而不是使用我們先前一直使用的View()方法）,對於File()方法有3類返回類型：FilePathResult,FileContentResult和FileStreamResult,第一種類型用於直接從磁盤返回文件；第二種類型用於將byte數組返回客戶端；而第三種方式將已經生成並打開的流對象的內容返回客戶端。

如果你還記得的話，我們將上傳的文件存入了數據庫，並以byte數組的形式存入FileContent域內.而當需要提取時，它仍然會以一個byte數組進行提取，這意味著我們使用返回FileContentResult的File()重載,如果我們想讓提取的文件名更有意義，我們使用接受3個參數的重載，三個參數是:byte數組，MIME類型，文件名:

public FileContentResult GetFile(int id) 
{ 
 SqlDataReader rdr; byte[] fileContent = null;  
 string mimeType = "";string fileName = ""; 
 const string connect = @"Server=.\SQLExpress;Database=FileTest;Trusted_Connection=True;"; 
 using (var conn = new SqlConnection(connect)) 
 { 
  var qry = "SELECT FileContent, MimeType, FileName FROM FileStore WHERE ID = @ID"; 
  var cmd = new SqlCommand(qry, conn); 
  cmd.Parameters.AddWithValue("@ID", id); 
  conn.Open(); 
  rdr = cmd.ExecuteReader(); 
  if (rdr.HasRows) 
  { 
   rdr.Read(); 
   fileContent = (byte[])rdr["FileContent"]; 
   mimeType = rdr["MimeType"].ToString(); 
   fileName = rdr["FileName"].ToString(); 
  } 
 } 
 return File(fileContent, mimeType, fileName); 
}

在View中最簡單的使用來使用這個Action只需提供一個超鏈接：

<a href="/GetFile/1">Click to get file</a>

如果在數據庫中存儲的圖片是圖片類型，和使用超鏈接不同的是，我們通過指向Controller action的一個帶有src屬性的<image>標簽來獲取:

<img src="/GetFile/1" alt="My Image" />

下面再讓我們來看看使用FilePathResult（用於從硬盤提取文件）是多簡單的事：

public FilePathResult GetFileFromDisk() 
{ 
 string path = AppDomain.CurrentDomain.BaseDirectory + "uploads/"; 
 string fileName = "test.txt"; 
 return File(path + fileName, "text/plain", "test.txt"); 
}

而這也可以用過超鏈接提取:

<a href="/GetFileFromDisk">Click to get file</a>

而最後一個選擇FileStreamResult也可以從磁盤中提取文件:

public FileStreamResult StreamFileFromDisk() 
{ 
 string path = AppDomain.CurrentDomain.BaseDirectory + "uploads/"; 
 string fileName = "test.txt"; 
 return File(new FileStream(path + fileName, FileMode.Open), "text/plain", fileName); 
}

三、補充

FilePathResult和FileStreamResult的區別是什麼？我們又該如何取捨呢？主要的區別是FilePathResult使用HttpResponse.TransmitFile來將文件寫入Http輸出流。這個方法並不會在服務器內存中進行緩沖，所以這對於發送大文件是一個不錯的選擇。他們的區別很像DataReader和DataSet的區別。於此同時， TransmitFile還有一個bug,這可能導致文件傳到客戶端一半就停了，甚至無法傳送。而FileStreamResult在這方面就很棒了。比如說：返回Asp.net Chart 控件在內存中生成的圖表圖片，而這並不需要將圖片存到磁盤中.