轉 2003年的 asp.net webservices 上傳下載文件

一：通過Web Services顯示和下載文件

我們這裏建立的Web Services的名稱爲GetBinaryFile，提供兩個公共方法：分別是GetImage()和GetImageType()，前者返回二進制文件字節數組，後者返回文件類型，其中，GetImage()方法有一個參數，用來在客戶端選擇要顯示或下載的文件名字。這裏我們所顯示和下載的文件可以不在虛擬目錄下，採用這個方法的好處是：可以根據權限對文件進行顯示和下載控制，從下面的方法我們可以看出，實際的文件位置並沒有在虛擬目錄下，因此可以更好地對文件進行權限控制，這在對安全性有比較高的情況下特別有用。這個功能在以前的ASP程序中可以用Stream對象實現。爲了方便讀者進行測試，這裏列出了全部的源代碼，並在源代碼裏進行介紹和註釋。

首先，建立GetBinaryFile.asmx文件：

我們可以在VS.NET裏新建一個C#的aspxWebCS工程，然後“添加新項”，選擇“Web服務”，並設定文件名爲：GetBinaryFile.asmx，在“查看代碼”中輸入以下代碼，即：GetBinaryFile.asmx.cs：

1. using System;
2.     using System.Collections;
3.     using System.ComponentModel;
4.     using System.Data;
5.     using System.Diagnostics;
6.     using System.Web;
7.     using System.Web.UI;
8.     using System.Web.Services;
9.     using System.IO;
11.     namespace xml.sz.luohuedu.net.aspxWebCS
12.     {
13.         /// <summary>
14.         /// GetBinaryFile 的摘要說明。
15.         /// Web Services名稱：GetBinaryFile
16.         /// 功能：返回服務器上的一個文件對象的二進制字節數組。
17.         /// </summary>
18.     [WebService(Namespace="http://xml.sz.luohuedu.net/",
19.         Description="在Web Services裏利用.NET框架進行傳遞二進制文件。")]
20.         public class GetBinaryFile : System.Web.Services.WebService
21.         {
23.             #region Component Designer generated code
24.             //Web 服務設計器所必需的
25.             private IContainer components = null;
27.             /// <summary>
28.             /// 清理所有正在使用的資源。
29.             /// </summary>
30.             protected override void Dispose( bool disposing )
31.             {
32.                 if(disposing && components != null)
33.                 {
34.                     components.Dispose();
35.                 }
36.                 base.Dispose(disposing);
37.             }
39.             #endregion
41.        public class Images: System.Web.Services.WebService
42.       {
43.        /// <summary>
44.        /// Web 服務提供的方法，返回給定文件的字節數組。
45.        /// </summary>
46.        [WebMethod(Description="Web 服務提供的方法，返回給定文件的字節數組")]
47.        public byte[] GetImage(string requestFileName)
48.        {
49.         ///得到服務器端的一個圖片
50.         ///如果你自己測試，注意修改下面的實際物理路徑
51.         if(requestFileName == null || requestFileName == "")
52.          return getBinaryFile("D://Picture.JPG");
53.         else
54.          return getBinaryFile("D://" + requestFileName);
55.        }
57.        /// <summary>
58.        /// getBinaryFile：返回所給文件路徑的字節數組。
59.        /// </summary>
60.        /// <param name="filename"></param>
61.        /// <returns></returns>
62.        public byte[] getBinaryFile(string filename)
63.        {
64.         if(File.Exists(filename))
65.         {
66.          try
67.          {
68.           ///打開現有文件以進行讀取。
69.           FileStream s = File.OpenRead(filename);
70.           return ConvertStreamToByteBuffer(s);
71.          }
72.          catch(Exception e)
73.          {
74.           return new byte[0];
75.          }
76.         }
77.         else
78.         {
79.          return new byte[0];
80.         }
81.        }
82.      /// <summary>
83.      /// ConvertStreamToByteBuffer：把給定的文件流轉換爲二進制字節數組。
84.      /// </summary>
85.      /// <param name="theStream"></param>
86.      /// <returns></returns>
87.        public byte[] ConvertStreamToByteBuffer(System.IO.Stream theStream)
88.        {
89.         int b1;
90.         System.IO.MemoryStream tempStream = new System.IO.MemoryStream();
91.         while((b1=theStream.ReadByte())!=-1)
92.         {
93.          tempStream.WriteByte(((byte)b1));
94.         }
95.         return tempStream.ToArray();
96.        }
97.         [WebMethod(Description="Web 服務提供的方法，返回給定文件類型。")]
98.         public string GetImageType()
99.         {
100.          ///這裏只是測試，您可以根據實際的文件類型進行動態輸出
101.          return "image/jpg";
102.         }
103.       }
104.     }
105.     }

一旦我們創建了上面的asmx文件，進行編譯後，我們就可以編寫客戶端的代碼來進行調用這個Web Services了。

我們先“添加Web引用”，輸入：http://localhost/aspxWebCS/GetBinaryFile.asmx。下面，我們編寫顯示文件的中間文件：GetBinaryFileShow.aspx，這裏，我們只需要在後代碼裏編寫代碼即可，GetBinaryFileShow.aspx.cs文件內容如下：

1. using System;
2.     using System.Collections;
3.     using System.ComponentModel;
4.     using System.Data;
5.     using System.Drawing;
6.     using System.Web;
7.     using System.Web.SessionState;
8.     using System.Web.UI;
9.     using System.Web.UI.WebControls;
10.     using System.Web.UI.HtmlControls;
11.     using System.Web.Services;
13.     namespace aspxWebCS
14.     {
15.         /// <summary>
16.         /// GetBinaryFileShow 的摘要說明。
17.         /// </summary>
18.         public class GetBinaryFileShow : System.Web.UI.Page
19.         {
21.             private void Page_Load(object sender, System.EventArgs e)
22.             {
23.             // 在此處放置用戶代碼以初始化頁面
24.            ///定義並初始化文件對象；
25.            xml.sz.luohuedu.net.aspxWebCS.GetBinaryFile.Images oImage;
26.            oImage = new xml.sz.luohuedu.net.aspxWebCS.GetBinaryFile.Images();
27.            ///得到二進制文件字節數組；
28.            byte[] image = oImage.GetImage("");
29.            ///轉換爲支持存儲區爲內存的流
30.            System.IO.MemoryStream memStream = new System.IO.MemoryStream(image);
31.            ///定義並實例化Bitmap對象
32.            Bitmap bm = new Bitmap(memStream);
33.            ///根據不同的條件進行輸出或者下載；
34.            Response.Clear();
35.            ///如果請求字符串指定下載，就下載該文件；
36.            ///否則，就顯示在瀏覽器中。
37.            if(Request.QueryString["Download"]=="1")
38.            {
39.             Response.Buffer = true;
40.             Response.ContentType = "application/octet-stream";
41.             ///這裏下載輸出的文件名字 ok.jpg 爲例子，你實際中可以根據情況動態決定。
42.             Response.AddHeader("Content-Disposition","attachment;filename=ok.jpg");
43.            }
44.            else
45.             Response.ContentType = oImage.GetImageType();
46.            Response.BinaryWrite(image);
47.            Response.End();
48.             }
50.             #region Web Form Designer generated code
51.             override protected void OnInit(EventArgs e)
52.             {
53.                 //
54.                 // CODEGEN：該調用是 ASP.NET Web 窗體設計器所必需的。
55.                 //
56.                 InitializeComponent();
57.                 base.OnInit(e);
58.             }
60.             /// <summary>
61.             /// 設計器支持所需的方法 - 不要使用代碼編輯器修改
62.             /// 此方法的內容。
63.             /// </summary>
64.             private void InitializeComponent()
65.             {
66.        this.Load += new System.EventHandler(this.Page_Load);
68.       }
69.             #endregion
70.         }
71.     }

 

最後，我們就編寫最終的瀏覽頁面：GetBinaryFile.aspx，這個文件很簡單，只需要aspx文件即可，內容如下：

 

1. <%@ Page language="c#" Codebehind="GetBinaryFile.aspx.cs" AutoEventWireup="false"
2.       Inherits="aspxWebCS.GetBinaryFile" %>
3.     <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" >
4.     <HTML>
5.       <HEAD>
6.         <title>通過Web Services顯示和下載文件</title>
7.         <meta name="GENERATOR" Content="Microsoft Visual Studio 7.0">
8.         <meta name="CODE_LANGUAGE" Content="C#">
9.         <meta name="vs_defaultClientScript" content="JavaScript">
10.         <meta name="vs_targetSchema" content="http://schemas.microsoft.com/intellisense/ie5">
11.       </HEAD>
12.       <body MS_POSITIONING="GridLayout">
13.         <form id="GetBinaryFile" method="post" runat="server">
14.           <FONT face="宋體">
15.             <asp:HyperLink id="HyperLink1" NavigateUrl="GetBinaryFileShow.aspx?Download=1"
16.              runat="server">下載文件</asp:HyperLink>
17.             <br/>
18.             <!--下面是直接顯示文件-->
19.             <asp:Image id="Image1" ImageUrl="GetBinaryFileShow.aspx" runat="server"></asp:Image>
20.           </FONT>
21.         </form>
22.       </body>
23.     </HTML>

 

二：通過Web Services上載文件

向服務器上載文件可能有許多種方法，在利用Web Services上載文件的方法中，下面的這個方法應該是最簡單的了。我們仍象前面的例子那樣，首先建立Upload.asmx文件，其Upload.asmx.cs內容如下，裏面已經做了註釋：

1. using System;
2.     using System.Collections;
3.     using System.ComponentModel;
4.     using System.Data;
5.     using System.Diagnostics;
6.     using System.Web;
7.     using System.Web.Services;
8.     using System.IO;
10.     namespace xml.sz.luohuedu.net.aspxWebCS
11.     {
12.         /// <summary>
13.         /// Upload 的摘要說明。
14.         /// </summary>
15.      [WebService(Namespace="http://xml.sz.luohuedu.net/",
16.         Description="在Web Services裏利用.NET框架進上載文件。")]
17.         public class Upload : System.Web.Services.WebService
18.         {
19.             public Upload()
20.             {
21.                 //CODEGEN：該調用是 ASP.NET Web 服務設計器所必需的
22.                 InitializeComponent();
23.             }
25.             #region Component Designer generated code
27.             //Web 服務設計器所必需的
28.             private IContainer components = null;
30.             /// <summary>
31.             /// 設計器支持所需的方法 - 不要使用代碼編輯器修改
32.             /// 此方法的內容。
33.             /// </summary>
34.             private void InitializeComponent()
35.             {
36.             }
38.             /// <summary>
39.             /// 清理所有正在使用的資源。
40.             /// </summary>
41.             protected override void Dispose( bool disposing )
42.             {
43.                 if(disposing && components != null)
44.                 {
45.                     components.Dispose();
46.                 }
47.                 base.Dispose(disposing);
48.             }
50.             #endregion
52.       [WebMethod(Description="Web 服務提供的方法，返回是否文件上載成功與否。")]
53.       public string UploadFile(byte[] fs,string FileName)
54.       {
55.        try
56.        {
57.         ///定義並實例化一個內存流，以存放提交上來的字節數組。
58.         MemoryStream m = new MemoryStream(fs);
59.         ///定義實際文件對象，保存上載的文件。
60.         FileStream f = new FileStream(Server.MapPath(".") + "//"
61.          + FileName, FileMode.Create);
62.         ///把內內存裏的數據寫入物理文件
63.         m.WriteTo(f);
64.         m.Close();
65.         f.Close();
66.         f = null;
67.         m = null;
68.         return "文件已經上傳成功。";
69.        }
70.        catch(Exception ex)
71.        {
72.         return ex.Message;
73.        }
74.       }
75.     }
76.     }

 

要上載文件，必須提供一個表單，來供用戶進行文件的選擇，下面我們就建立這樣一個頁面Upload.aspx，用來提供文件上載：

1. <%@ Page language="c#" Codebehind="Upload.aspx.cs" AutoEventWireup="false"
2.       Inherits="aspxWebCS.Upload" %>
3.     <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
4.     <HTML>
5.       <HEAD>
6.         <title>通過Web Services上載文件</title>
7.         <meta name="GENERATOR" content="Microsoft Visual Studio .NET 7.0">
8.         <meta name="CODE_LANGUAGE" content="Visual Basic 7.0">
9.         <meta name="vs_defaultClientScript" content="JavaScript">
10.         <meta name="vs_targetSchema" content="http://schemas.microsoft.com/intellisense/ie5">
11.       </HEAD>
12.       <body MS_POSITIONING="GridLayout">
13.         <form id="Form1" method="post" runat="server"  enctype="multipart/form-data">
14.           <INPUT id="MyFile" type="file" runat="server">
15.           <br>
16.           <br>
17.           <asp:Button id="Button1" runat="server" Text="上載文件"></asp:Button>
18.         </form>
19.       </body>
20.     </HTML>

 

我們要進行處理的是在後代碼裏面，下面詳細的介紹，Upload.aspx.cs：

1. using System;
2.     using System.Collections;
3.     using System.ComponentModel;
4.     using System.Data;
5.     using System.Drawing;
6.     using System.Web;
7.     using System.Web.SessionState;
8.     using System.Web.UI;
9.     using System.Web.UI.WebControls;
10.     using System.Web.UI.HtmlControls;
11.     using System.Web.Services;
12.     using System.IO;
14.     namespace aspxWebCS
15.     {
16.         /// <summary>
17.         /// Upload 的摘要說明。
18.         /// 利用該方法通過Web Services上載文件
19.         /// </summary>
20.         public class Upload : System.Web.UI.Page
21.         {
22.       protected System.Web.UI.HtmlControls.HtmlInputFile MyFile;
23.       protected System.Web.UI.WebControls.Button Button1;
25.             private void Page_Load(object sender, System.EventArgs e)
26.             {
27.                 // 在此處放置用戶代碼以初始化頁面
28.             }
30.             #region Web Form Designer generated code
31.             override protected void OnInit(EventArgs e)
32.             {
33.                 //
34.                 // CODEGEN：該調用是 ASP.NET Web 窗體設計器所必需的。
35.                 //
36.                 InitializeComponent();
37.                 base.OnInit(e);
38.             }
40.             /// <summary>
41.             /// 設計器支持所需的方法 - 不要使用代碼編輯器修改
42.             /// 此方法的內容。
43.             /// </summary>
44.             private void InitializeComponent()
45.             {
46.        this.Button1.Click += new System.EventHandler(this.Button1_Click);
47.        this.Load += new System.EventHandler(this.Page_Load);
49.       }
50.             #endregion
52.       private void Button1_Click(object sender, System.EventArgs e)
53.       {
54.        ///首先得到上載文件信息和文件流
55.        if(MyFile.PostedFile != null)
56.        {
57.         System.Web.HttpFileCollection oFiles;
58.         oFiles = System.Web.HttpContext.Current.Request.Files;
59.         if(oFiles.Count < 1)
60.         {
61.          Response.Write ("請選擇文件。");
62.          Response.End();
63.         }
65.         string FilePath = oFiles[0].FileName;
66.         if(FilePath == "" || FilePath == null)
67.         {
68.          Response.Write ("請選擇一個文件。");
69.          Response.End();
70.         }
71.         string FileName = FilePath.Substring(FilePath.LastIndexOf("//")+1);
72.         try
73.         {
74.          ///處理上載的文件流信息。
75.          byte[] b = new byte[oFiles[0].ContentLength];
76.          System.IO.Stream fs;
77.          xml.sz.luohuedu.net.aspxWebCS.Upload o;
78.          o = new xml.sz.luohuedu.net.aspxWebCS.Upload();
79.          fs = (System.IO.Stream)oFiles[0].InputStream;
80.          fs.Read(b, 0, oFiles[0].ContentLength);
81.          ///調用Web Services的UploadFile方法進行上載文件。
82.          Response.Write(o.UploadFile(b, FileName));
83.          fs.Close();
84.         }
85.         catch(Exception ex)
86.         {
87.          Response.Write(ex.Message);
88.         }
89.        }
90.        else
91.        {
92.         Response.Write("請選擇文件");
93.     }
94.    }
95.   }
96.  }

 

最後，需要注意的是：在保存文件時，您應該確保指定文件的完整路徑（例如，"C:/MyFiles/Picture.jpg"），並確保爲 ASP.NET 使用的帳戶提供要存儲文件的目錄的寫權限。上載大文件時，可使用 元素的 maxRequestLength 屬性來增加文件大小的最大允許值，例如：

其中：maxRequestLength：指示 ASP.NET 支持的HTTP方式上載的最大字節數。該限制可用於防止因用戶將大量文件傳遞到該服務器而導致的拒絕服務攻擊。指定的大小以 KB 爲單位。默認值爲 4096 KB (4 MB)。executionTimeout：指示在被 ASP.NET 自動關閉前，允許執行請求的最大秒數。在當文件超出指定的大小時，如果瀏覽器中會產生 DNS 錯誤或者出現服務不可得到的情況，也請修改以上的配置，把配置數加大。

另外，上載大文件時，還可能會收到以下錯誤信息：

aspnet_wp.exe (PID: 1520) 被回收，因爲內存消耗超過了 460 MB（可用 RAM 的百分之 60）。

如果遇到此錯誤信息，請增加應用程序的 Web.config 文件的 元素中 memoryLimit 屬性的值。例如：