模板
教程
环境
性能
功能
管理
同步http处理程序(IHttpHandler)
本主题阐释一个 HTTP 处理程序的代码，该处理程序对 ASP.NET 应用程序中其 URL 以 .sample 结尾的资源执行同步请求处理。此代码示例阐释了下列内容：
一个 HTTP 处理程序类的代码。该类必须实现 ProcessRequest 方法和 IsReusable 属性。
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 方法并将一个字符串写出到当前 HttpContext 对象的 Response 属性中。
注册自定义 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 应用程序的说明，请参见如何：在 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 类中定义的文本
