Happy to Help

Creating a Synchronous HTTP Handler

<div dir="ltr" style="text-align: left;" trbidi="on">
<h2>
<span style="font-family: Verdana, sans-serif;">To create the custom HelloWorldHandler HTTP handler class</span></h2>
<span style="font-family: Verdana, sans-serif;"><br /> 1.) In Solution Explorer, right-click the project, click Add ASP.NET Folder, and then click App_Code. <br /> 2.) In the App_Code folder, create a class named HelloWorldHandler and add the following code to the class file.</span><br />
<div>
<span style="font-family: Verdana, sans-serif;"><br /></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /><i><span style="color: red;">using System.Web; <br /> public class HelloWorldHandler : IHttpHandler <br /> { <br />   public HelloWorldHandler() <br />   { <br />   } <br />   public void ProcessRequest(HttpContext context) <br />   { <br />     HttpRequest Request = context.Request; <br />     HttpResponse Response = context.Response;<br />     // This handler is called whenever a file ending <br />     // in .sample is requested. A file with that extension <br />     // does not need to exist. <br />     Response.Write("<html>"); <br />     Response.Write("<body>"); <br />     Response.Write("<h1>Hello from a synchronous custom HTTP handler.</h1>"); <br />     Response.Write("</body>"); <br />     Response.Write("</html>"); <br />   } <br />   public bool IsReusable <br />   { <br />     // To enable pooling, return true here. <br />     // This keeps the handler in memory. <br />     get { return false; } <br />   } <br /> } </span></i></span><br />
<h2>
<span style="font-family: Verdana, sans-serif;">Registering the Custom HTTP Handler in IIS 6.0
</span></h2>
<span style="font-family: Verdana, sans-serif;"><br />After you have created the custom HTTP handler class, you must register it in the application's Web.config file. This enables ASP.NET to find the handler when requests are made for resources whose URL ends with .sample.
<br /><br />There are different procedures for registering the handler, depending on whether you are working with IIS 6.0 or IIS 7.0. This section describes how to register a handler in IIS 6.0. The next section describes how to register a handler in IIS 7.0.
<br />

To register the handler in IIS 6.0 </span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br />Add the following highlighted element to the Web.config file.</span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /><i><span style="color: red;">

<configuration> <br />  <system.web> <br />   <httpHandlers> <br />    <add verb="*" path="*.sample" <br />     type="HelloWorldHandler"/> <br />   </httpHandlers> <br />  </system.web> <br /> </configuration> </span></i><br />The configuration element registers the custom handler by class name, and it maps the .sample file name extension to that handler.<br /><br />Register an application extension mapping for the .sample file name extension by using IIS Manager. For more information, see <a href="http://msdn.microsoft.com/en-us/library/bb515343(v=vs.100).aspx">How to: Configure an HTTP Handler Extension in IIS</a>.</span><br />
<h2>
<span style="font-family: Verdana, sans-serif;">Registering the Custom HTTP Handler in IIS 7.0
</span></h2>
<span style="font-family: Verdana, sans-serif;"><br />In IIS 7.0, an application can run in either Classic or Integrated mode. In Classic mode, requests are processed much the same way as they are in IIS 6.0. In Integrated mode, IIS 7.0 manages requests by using a pipeline that enables it to share requests, modules, and other features with ASP.NET.
<br /><br />For IIS 7.0, the handler registration requires either registering the handler in the Web.config file or in IIS Manager. Because of the centralized administration in IIS 7.0, changes in an application's Web.config file are reflected in IIS Manager interface for the application and vice versa. In the following procedures, the handlers are registered in the Web.config file.
<br /><br />There are different procedures for registering the handler for IIS 7.0 running in Classic mode and running in Integrated mode. Follow the procedure for the IIS mode that you are using. </span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /></span>
<h2>
<span style="font-family: Verdana, sans-serif;">

To register the handler in IIS 7.0 running in
Classic mode
</span></h2>
<span style="font-family: Verdana, sans-serif;"><br /></span><span style="font-family: Verdana, sans-serif;">Add the following highlighted element to the Web.config file.</span><span style="font-family: Verdana, sans-serif;"><br /><br /><i><span style="color: red;"><configuration> <br />  <system.web><br />   <httpHandlers> <br />    <add verb="*" path="*.sample" <br />     type="HelloWorldHandler"/> <br />   </httpHandlers> <br />  </system.web> <br />   <system.webServer> <br />     <handlers> <br />       <add verb="*" path="*.sample" <br />          name="HelloWorldHandler"<br />          type="HelloWorldHandler" <br />          modules="IsapiModule"/><br />          scriptProcessor="%path%\aspnet_isapi.dll" <br />     </handlers> <br />   </system.webServer> <br /> </configuration> </span></i><br /><br />

The configuration element registers the custom handler by class name and maps the .sample file name extension to that handler.<br /><br />Because you are registering a custom file name extension, you register the handler in both the handlers section and the httpHandlers section. In Classic mode, for backward compatibility, the handler is specified as an ISAPI module by using the modules attribute. The path of the ASP.NET ISAPI dll is specified by using the scriptProcessor attribute. The name attribute is required in the handlers section.
</span><br />
<h2>
<span style="font-family: Verdana, sans-serif;">

To register the handler in IIS 7.0 running in Integrated mode
</span></h2>
<span style="font-family: Verdana, sans-serif;"><br /></span><span style="font-family: Verdana, sans-serif;">Add the following highlighted element to the Web.config file.</span><span style="font-family: Verdana, sans-serif;"><br /><br /><span style="color: red;"><i>

<configuration> </i></span></span></div>
<div>
<span style="color: red; font-family: Verdana, sans-serif;"><i> <system.webServer></i></span></div>
<div>
<span style="color: red; font-family: Verdana, sans-serif;"><i> <handlers> </i></span></div>
<div>
<span style="color: red; font-family: Verdana, sans-serif;"><i> <add verb="*" path="*.sample"   
     name="HelloWorldHandler"  
     type="HelloWorldHandler"/></i></span></div>
<div>
<span style="color: red; font-family: Verdana, sans-serif;"><i> </handlers></i></span></div>
<div>
<span style="color: red; font-family: Verdana, sans-serif;"><i> </system.webServer></i></span></div>
<div>
<span style="color: red; font-family: Verdana, sans-serif;"><i> </configuration> </i></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"> The configuration element registers the custom handler by class name and maps the .sample file name extension to that handler.</span></div>
<h2>
<br /><span style="font-family: Verdana, sans-serif;">Testing the Custom HTTP Handler </span></h2>
<div>
<span style="font-family: Verdana, sans-serif;"> After you have created and registered the custom HTTP handler, you can test it.
 To test your custom HTTP handler
In the browser, request a page from the Web application. </span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"> In the browser, enter a URL that ends in .sample. For example, enter the following URL:</span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"> <i><span style="color: red;">http://localhost/HttpHandler/test.sample </span></i></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"><br /></span></div>
<div>
<span style="font-family: Verdana, sans-serif;"> The text defined in the HelloWorldHandler class is displayed.</span>
<br />
<span style="line-height: 14.545454025268555px;">
</span></div>
</div>

Creating a Synchronous HTTP Handler

To create the custom HelloWorldHandler HTTP handler class 1.) In Solution Explorer, right-click the project, click Add ASP.NET Folder, and then click App_Code. 2.) In the App_Code folder, create a …