如何使用 Visual C# .NET 创建 ASP.NET HTTP 模块

实现模块

1.	新建一个名为 MyModule 的 Visual Studio .NET C# 类库项目。
2.	设置一个对 System.Web.dll 程序集的引用。
3.	将以下指令添加到该类中： using System.Web;
4.	重命名 SyncModule.cs 类，然后相应地更改类定义。
5.	实现 IHttpModule 接口。您的类定义应如下所示： public class SyncModule : IHttpModule
6.	决定要预订哪些事件。下表概括了可从 HttpApplication 对象预订的事件： • AcquireRequestState：调用此事件可允许模块获取或创建请求的状态（例如，会话）。 • AuthenticateRequest：当安全模块在处理请求前需要对用户进行身份验证时，调用此事件。 • AuthorizeRequest：当请求需要经过授权时，安全模块就会调用此事件。此事件是在身份验证后调用的。 • BeginRequest：调用此事件以通知模块新请求即将开始。 • Disposed：调用此事件以通知模块由于某种原因应用程序即将终止。允许模块进行内部清理。 • EndRequest：调用此事件以通知模块该请求即将结束。 • Error：调用此事件以通知模块在请求处理过程中发生了错误。 • PostRequestHandlerExecute：调用此事件以通知模块处理程序已完成对请求的处理。 • PreRequestHandlerExecute：调用此事件以通知模块将调用用于处理请求的处理程序。 • PreSendRequestContent：调用此事件以通知模块将向客户端发送请求内容。 • PreSendRequestHeaders：调用此事件以通知模块将向客户端发送 HTTP 头。 • ReleaseRequestState：调用此事件以允许模块在处理程序完成对请求的处理后释放状态。 • ResolveRequestCache：在身份验证后调用此事件。缓存模块使用此事件确定该请求是否应该由其缓存处理，或者处理程序是否应该处理该请求。 • UpdateRequestCache：在处理程序响应后调用此事件。缓存模块应根据该响应来更新其缓存。 本示例使用了 BeginRequest 事件。
7.	按以下方式实现 IHttpModule 接口的 Init 和 Dispose 方法： public void Init(HttpApplication app)             {             app.BeginRequest += new EventHandler(OnBeginRequest);             }             public void Dispose(){ }
8.	按以下方式为事件创建一个委托： public delegate void MyEventHandler(Object s, EventArgs e);
9.	定义一个 MyEventHandler 类型的私有局部变量以记录对该事件的引用： private MyEventHandler _eventHandler = null;
10.	创建一个事件将该委托挂接到 Global.asax 文件中的方法或从 HttpApplication 对象继承的类： public event MyEventHandler MyEvent             {             add { _eventHandler += value; }             remove { _eventHandler -= value; }             }
11.	创建 OnBeginRequest 方法，该方法挂接到 HttpApplication 的 BeginRequest 事件： public void OnBeginRequest(Object s, EventArgs e)             {             HttpApplication app = s as HttpApplication;             app.Context.Response.Write("Hello from OnBeginRequest in custom module.<br>");             if(_eventHandler!=null)             _eventHandler(this, null);             }
12.	编译该项目。

 

部署模块

1.	在 C:\Inetpub\Wwwroot 下新建一个名为 Module 的目录。
2.	在新创建的 Module 目录下创建一个名为 Bin 的子目录。这样，其路径为 C:\Inetpub\Wwwroot\Module\Bin。
3.	将 MyModule.dll 从项目的 Bin\Debug 目录复制到 C:\Inetpub\Wwwroot\Module\Bin 目录。
4.	按照下列步骤将新的 Module 目录标记为一个 Web 应用程序： a. 打开 Internet 服务管理器。 b. 右键单击 Module 目录，然后单击属性。 c. 在目录选项卡上，单击创建。 d. 单击确定以关闭 Module 属性对话框。

 

配置系统

1.	在 C:\Inetpub\Wwwroot\Module\ 目录下，新建一个名为 Web.config 的文件。
2.	将以下文本粘贴到 Web.config 文件中： <configuration>          <system.web>          <httpModules>          <add name="MyModule" type="MyModule.SyncModule, MyModule" />          </httpModules>          </system.web> </configuration>

 

测试模块

1.	在 C:\Inetpub\Wwwroot\Module 目录下，新建一个名为 Test.aspx 的 .aspx 文件。
2.	将以下文本粘贴到 Test.aspx 文件中： %@Page Language="C#"% <% Response.Write("Hello from Test.aspx.<br>"); %>
3.	在 C:\Inetpub\Wwwroot\Module 目录下，创建一个 Global.asax 文件。
4.	将以下代码粘贴到 Global.asax 文件中：  <%@ Import Namespace="MyModule" %>             <script language="C#" runat=server >             protected void MyModule_OnMyEvent(Object src, EventArgs e)             {             Context.Response.Write("Hello from MyModule_OnMyEvent called in Global.asax.<br>");             }             </script>
5.	请求 Test.aspx 页。应该会看到以下文本行： Hello from OnBeginRequest in custom module. Hello from MyModule_OnMyEvent called in Global.asax. Hello from Test.aspx.