学步园

随着Internet技术的发展和跨平台需求的日益增加，Web Services的应用越来越广，我们不但需要通过Web Services传递字符串信息，而且需要传递二进制文件信息。下面，我们就分别介绍如何通过Web Services从服务器下载文件到客户端和从客户端通过Web Services上载文件到服务器。

一：通过Web Services显示和下载文件

我们这里建立的Web Services的名称为GetBinaryFile，提供两个公共方法：分别是GetImage()和GetImageType()，前者返回二进制文件字节数组，后者返回文件类型，其中，GetImage()方法有一个参数，用来在客户端选择要显示或下载的文件名字。这里我们所显示和下载的文件可以不在虚拟目录下，采用这个方法的好处是：可以根据权限对文件进行显示和下载控制，从下面的方法我们可以看出，实际的文件位置并没有在虚拟目录下，因此可以更好地对文件进行权限控制，这在对安全性有比较高的情况下特别有用。这个功能在以前的ASP程序中可以用Stream对象实现。为了方便读者进行测试，这里列出了全部的源代码，并在源代码里进行介绍和注释。

首先，建立GetBinaryFile.asmx文件：

我们可以在VS.NET里新建一个C#的aspxWebCS工程，然后“添加新项”，选择“Web服务”，并设定文件名为：GetBinaryFile.asmx，在“查看代码”中输入以下代码，即：GetBinaryFile.asmx.cs：

using System;
    using System.Collections;
    using System.ComponentModel;
    using System.Data;
    using System.Diagnostics;
    using System.Web;
    using System.Web.UI;
    using System.Web.Services;
    using System.IO;

    namespace xml.sz.luohuedu.net.aspxWebCS
    ...{
        /**//// <summary>
        /// GetBinaryFile 的摘要说明。
        /// Web Services名称：GetBinaryFile
        /// 功能：返回服务器上的一个文件对象的二进制字节数组。
        /// </summary>
    [WebService(Namespace="http://xml.sz.luohuedu.net/",
        Description="在Web Services里利用.NET框架进行传递二进制文件。")]
        public class GetBinaryFile : System.Web.Services.WebService
        ...{

            Component Designer generated code#region Component Designer generated code
            //Web 服务设计器所必需的
            private IContainer components = null;

            /**//// <summary>
            /// 清理所有正在使用的资源。
            /// </summary>
            protected override void Dispose( bool disposing )
            ...{
                if(disposing && components != null)
                ...{
                    components.Dispose();
                }
                base.Dispose(disposing);
            }

            #endregion

       public class Images: System.Web.Services.WebService
      ...{
       /**//// <summary>
       /// Web 服务提供的方法，返回给定文件的字节数组。
       /// </summary>
       [WebMethod(Description="Web 服务提供的方法，返回给定文件的字节数组")]
       public byte[] GetImage(string requestFileName)
       ...{
        /**////得到服务器端的一个图片
        ///如果你自己测试，注意修改下面的实际物理路径
        if(requestFileName == null || requestFileName == "")
         return getBinaryFile("D:/Picture.JPG");
        else
         return getBinaryFile("D:/" + requestFileName);
       }

       /**//// <summary>
       /// getBinaryFile：返回所给文件路径的字节数组。
       /// </summary>
       /// <param name="filename"></param>
       /// <returns></returns>
       public byte[] getBinaryFile(string filename)
       ...{
        if(File.Exists(filename))
        ...{
         try
         ...{
          /**////打开现有文件以进行读取。
          FileStream s = File.OpenRead(filename);
          return ConvertStreamToByteBuffer(s);
         }
         catch(Exception e)
         ...{
          return new byte[0];
         }
        }
        else
        ...{
         return new byte[0];
        }
       }
     /**//// <summary>
     /// ConvertStreamToByteBuffer：把给定的文件流转换为二进制字节数组。
     /// </summary>
     /// <param name="theStream"></param>
     /// <returns></returns>
       public byte[] ConvertStreamToByteBuffer(System.IO.Stream theStream)
       ...{
        int b1;
        System.IO.MemoryStream tempStream = new System.IO.MemoryStream();
        while((b1=theStream.ReadByte())!=-1)
        ...{
         tempStream.WriteByte(((byte)b1));
        }
        return tempStream.ToArray();
       }
        [WebMethod(Description="Web 服务提供的方法，返回给定文件类型。")]
        public string GetImageType()
        ...{
         /**////这里只是测试，您可以根据实际的文件类型进行动态输出
         return "image/jpg";
        }
      }
    }
    }

一旦我们创建了上面的asmx文件，进行编译后，我们就可以编写客户端的代码来进行调用这个Web Services了。

我们先“添加Web引用”，输入：http://localhost/aspxWebCS/GetBinaryFile.asmx。下面，我们编写显示文件的中间文件：GetBinaryFileShow.aspx，这里，我们只需要在后代码里编写代码即可，GetBinaryFileShow.aspx.cs文件内容如下：

using System;
    using System.Collections;
    using System.ComponentModel;
    using System.Data;
    using System.Drawing;
    using System.Web;
    using System.Web.SessionState;
    using System.Web.UI;
    using System.Web.UI.WebControls;
    using System.Web.UI.HtmlControls;
    using System.Web.Services;

    namespace aspxWebCS
    ...{
        /**//// <summary>
        /// GetBinaryFileShow 的摘要说明。
        /// </summary>
        public class GetBinaryFileShow : System.Web.UI.Page
        ...{

            private void Page_Load(object sender, System.EventArgs e)
            ...{
            // 在此处放置用户代码以初始化页面
           /**////定义并初始化文件对象；
           xml.sz.luohuedu.net.aspxWebCS.GetBinaryFile.Images oImage;
           oImage = new xml.sz.luohuedu.net.aspxWebCS.GetBinaryFile.Images();
           /**////得到二进制文件字节数组；
           byte[] image = oImage.GetImage("");
           /**////转换为支持存储区为内存的流