本主题阐释一个 HTTP 处理程序的代码,该处理程序对 ASP.NET 应用程序中其 URL 以 .sample 结尾的资源执行同步请求处理。此代码示例阐释了下列内容:
-
一个 HTTP 处理程序类的代码。该类必须实现 方法和 属性。
-
Web.config 文件中注册该处理程序并将 .sample 文件扩展名映射到该处理程序所需的元素。
-
如何在 Internet 信息服务 (IIS) 中将 .sample 文件扩展名映射到 ASP.NET。
注意 |
---|
在将配置文件更改为包含对新处理程序的引用后,ASP.NET Development Server 将处理对新资源的请求。若要启用 IIS 以处理该请求,请参见下面的过程。 |
当用户请求一个其 URL 以 .sample 结尾的资源时,Web 服务器将该请求转发给 ASP.NET。然后 ASP.NET 调用 HTTP 处理程序,后者返回一个响应。该响应由该处理程序动态创建;不需要存在具有文件扩展名 .sample 的文件。有关 ASP.NET 如何与 Web 服务器交互的更多信息,请参见 ASP.NET 生命周期。
创建自定义 HelloWorldHandler HTTP 处理程序类
-
在网站的 App_Code 目录中,创建一个名为
HelloWorldHandler
的类。 -
向类文件中添加下面的代码。
Visual Basic Imports System.Web Public Class HelloWorldHandler Implements IHttpHandler Public Sub ProcessRequest(ByVal context As _ System.Web.HttpContext) Implements _ System.Web.IHttpHandler.ProcessRequest Dim request As HttpRequest = context.Request Dim response As HttpResponse = context.Response ' This handler is called whenever a file ending ' in .sample is requested. A file with that extension ' does not need to exist. response.Write("<html>") response.Write("<body>") response.Write("<h1>Hello from a synchronous custom HTTP handler.</h1>") response.Write("</body>") response.Write("</html>") End Sub Public ReadOnly Property IsReusable() As Boolean _ Implements System.Web.IHttpHandler.IsReusable Get Return False End Get End Property End Class
C# using System.Web; public class HelloWorldHandler : IHttpHandler { public HelloWorldHandler() { } public void ProcessRequest(HttpContext context) { HttpRequest Request = context.Request; HttpResponse Response = context.Response; // This handler is called whenever a file ending // in .sample is requested. A file with that extension // does not need to exist. Response.Write("<html>"); Response.Write("<body>"); Response.Write("<h1>Hello from a synchronous custom HTTP handler.</h1>"); Response.Write("</body>"); Response.Write("</html>"); } public bool IsReusable { // To enable pooling, return true here. // This keeps the handler in memory. get { return false; } } }
这段代码实现 ProcessRequest 方法并将一个字符串写出到当前 对象的 属性中。
注册自定义 HTTP 处理程序
创建完自定义 HTTP 处理程序类后,必须在应用程序的 Web.config 文件中注册它。这样,ASP.NET 在接收对其 URL 以 .sample 结尾的资源进行的请求时,可以找到该处理程序。
在 Web.config 文件中注册自定义 HTTP 处理程序
-
将一个 Web.config 文件添加到网站(如果该文件尚未存在)。
-
将下面突出显示的元素添加到 Web.config 文件中。
<configuration> <system.web> <httpHandlers> <add verb="*" path="*.sample" type="HelloWorldHandler"/> </httpHandlers> </system.web> </configuration>
这段代码按类名注册自定义处理程序,并将 .sample 文件扩展名映射到该处理程序。
在 IIS 6.0 中配置 HTTP 处理程序扩展名
IIS 只将针对某些文件类型的请求传递给 ASP.NET 进行处理。默认情况下,具有 .aspx、.ascx、.asmx 等文件扩展名的文件在 IIS 6.0 中已映射为 ASP.NET ISAPI 扩展名 (Aspnet_isapi.dll)。但如果希望 ASP.NET 处理自定义 URL 扩展名,则必须在 IIS 中映射这些扩展名。有关更多信息,请参见 ASP.NET 生命周期。
在 IIS 6.0 中将 .sample 文件扩展名映射到 ASP.NET
-
打开“Internet 信息服务(IIS)管理器”。
-
右击应用程序的名称,然后单击“属性”。
注意 有关创建 ASP.NET 应用程序的说明,请参见。
-
单击“虚拟目录”选项卡,然后单击“配置”。
-
在“映射”选项卡上,单击“添加”。
将显示“添加/编辑应用程序扩展名映射”对话框。
-
在“可执行文件”框中,键入或浏览至 Aspnet_isapi.dll 文件。默认情况下,该文件位于以下位置。
%windows%\Microsoft.NET\Framework\version\
注意 可以从其他映射(如 .aspx 文件的映射)获得完整路径和文件名。
-
在“扩展名”框中,键入 .sample。
-
清除“确认文件是否存在”复选框。
-
单击“确定”,然后关闭 IIS 管理器。
测试自定义 HTTP 处理程序
创建并注册了自定义 HTTP 处理程序后,可以通过请求具有 .sample 文件扩展名的资源对其进行测试。
测试自定义 HTTP 处理程序
-
在浏览器中,输入一个指向 Web 应用程序并以 .sample 结尾的 URL,如下所示:
http://localhost/SampleApplication/test.sample
将显示在
HelloWorldHandler
类中定义的文本。