<% @ webhandler language="C#" class="AverageHandler" %>
using System;
using System.Web;
public class AverageHandler : IHttpHandler
{
public bool IsReusable
{ get { return true; } }
public void ProcessRequest(HttpContext ctx)
{
ctx.Response.Write("hello");
}
}
我们都知道,HttpHandler是一个彻底自定义Http请求的方法,它通过web.config来定义Asp.Net运行时来过滤出要自定义的Http请求,发送到定义在web.config的指定类中。
利用.ashx文件是一个更好的方法,这个文件类似于.aspx文件,可以通过它来调用HttpHandler类,从而免去了普通.aspx页面的控件解析以及页面处理的过程。这个文件特别适合于生成动态图片,生成动态文本等内容。
建立方法如下:
首先打开一个Web项目,然后在任意目录下使用VS2003解决方案资源管理器的“添加”-->“添加新项”,在对话框中选择“文本文件”,然后在文件名处输入“TextBuilder.ashx”。
然后在同目录下,使用解决方案资源管理器,使用“添加”-->“添加类”,在类文件名处输入“TextBuilder.ashx.cs”。可以看出,它的文件命名规律与.aspx文件相同。
然后在.cs文件处输入以下代码(名称空间略):
publicsealedclass TextBuilder : IHttpHandler
{
publicvoid ProcessRequest(HttpContext context)
{
context.Response.ClearContent();
context.Response.ContentType ="text/plain";
context.Response.Write("Hello World");
context.Response.End();
}
publicbool IsReusable
{
get{ returntrue; }
}
}
然后在“TextBuilder.ashx”文件的第一行处输入上面这个类的调用代码:
最后保存并编译项目。
使用IE测试,输入这个.ashx的地址即可。
大家可以看出Response类有个OutputStream方法,可以向客户端输出二进制数据流,所以在我的项目中,使用这个方法,在一个.ashx中使用DundasChart控件就可以生成非常好的统计图,用它发送二进制数据,方便快捷,而且不需在web.config内输入任何配置代码。
.ashx文件有个缺点,他处理控件的回发事件非常麻烦,比如说如果用它来生成DataGrid的列表也不是不行,但是处理数据的回发,需要一些.aspx页的功能,只有自己手动处理这些功能。所以,一般使用.ashx,用来输出一些不需要回发处理的项目即可。
利用“一般处理程序”。如果你实用的是vs2005你在添加新项中可以见到“一般处理程序”,它的后缀名为.ashx。它是什么?其实它和.aspx很类似。先问问.aspx是如何工作的?也许你知道,.aspx能处理来自外部传入的请求,然后它还能处理这个请求并生成一个html作为结果返回。这是典型的处理外部请求的方式。.aspx就是专门为处理“典型”的请求而出现的。那么如果我们现在需要一种又能处理外部请求又需要我们自定义的处理这个请求那又要怎么做呢?(也就是不实用“典型”的方式来处理)。.ashx就能帮你做到这一点。
首先你发现 <%@ WebHandler Language="C#" class="ImageHandler" %>这句话。想想一个ASP.NET的页面是不是也有类似的东西。其实它表明了现在的这个文件可以处理一个来自外部的请求。当然就它是不行的。
接下来关键的东西就是底下建立的类,它实现了一个关键的接口:IHttpHandler。实现这个接口表明你现在将以何种方式来处理来自外部的请求。其中有一个方法和属性需要实现,你可以在ProcessRequest方法中编写如何处理请求的细节而IsReusable表明其它的请求是否可以使用这个类的一个实例。我们可以暂时忽略IsReusable属性。将焦点转到ProcessRequest方法上。在ProcessRequest中有一个参数context它是一个HttpContext类型,context对象提供对用于为 HTTP 请求提供服务的内部服务器对象(如 Request、Response、Session 和 Server)的引用。也就是可以访问我们的几大服务器对象。
现在来看个简单的例子。
请在你自己建立的WEB站点文件夹中随便放一个图片。我的想法是这样,我先将一个图片读取成一个二进制的数据然后在将这个二进制的数据转变成一个图片。这其中需要你建立两个文件。一个.ASPX文件和现在我们要实用的.ASHX文件。
文件ImageHandler.ashx
using System;
using System.Web;
///<summary>
/// 这就一个没有任何实现的一般处理程序。
///</summary>
publicclass ImageHandler : IHttpHandler {
publicvoid ProcessRequest (HttpContext context)
{
//获取虚拟目录的物理路径。
string path = context.Server.MapPath("");
//获取图片文件的二进制数据。
byte[] datas = System.IO.File.ReadAllBytes(path +"\\U1513.jpg");
//将二进制数据写入到输出流中。
context.Response.OutputStream.Write(datas, 0, datas.Length);
}
publicbool IsReusable {
get{
returnfalse;
}
}
}
default.aspx文件
注意上面的代码:<asp:Image ID="Image1" runat="server" ImageUrl="~/ImageHandler.ashx"/></div> 中ImageUrl指向的是ImageHandler.ashx文件。
它一般用于产生供浏览器处理的、不需要回发处理的数据格式,例如用于生成动态图片、动态文本、ajax检测用户名是否可用(ajax其实都适合)等内容。
.ashx初建会有起始代码,其中ContentType用于设置程序的输出类型,这段代码可以在页面上出处一段文本“Hello World”其次ashx文件是可以直接访问的。
注意:
实现HttpHandler得功能就必须实现IHttpHandler接口,而且,任何实现了该接口的类都可以用于处理输入的HTTP请求。
从上面的代码我们可以看到,实现该接口需要实现IsReusable属性和ProcessRequest方法。IsReusable可以用来设置是否可以重用此实例。
ProcessRequest方法是整个HTTP请求最终的处理方法。就是该文件的程序入口点,你可以在这个函数里面处理请求内容,并返回以及其他逻辑。