PROCEDIMENTOS: Criar um identificador HTTP do ASP.NET usando o Visual Basic .NET

Voltar para o início

Implementar o identificador

1. Abra o Microsoft Visual Studio .NET. No Visual Basic .NET, crie um projeto de biblioteca de classes chamado MyHandler.
2. Defina uma referência para a sub-rotina System.Web.dll.
3. Adicione o código a seguir para importar o espaço para nome System.Web:

   Imports System.Web

4. Renomeie a classe SyncHandler.cs e altere a definição de classe para refletir isso.
5. Implemente a interface IHttpHandler. Sua definição de classe deverá aparecer da seguinte maneira:

   Public Class SyncHandler
      Implements IHttpHandler

6. Implemente a propriedade IsReusable e o método ProcessRequest da interface IHttpHandler. Como este é um identificador síncrono, retorne False para a propriedade IsReusable a fim de que o identificador não seja agrupado.

   Public ReadOnly Property IsReusable() As Boolean _
   Implements IHttpHandler.IsReusable
      Get
         Return False
      End Get
   End Property
   
   Public Sub ProcessRequest(ByVal context As HttpContext) _
   Implements IHttpHandler.ProcessRequest
      context.Response.Write("Hello from custom handler.")
   End Sub

7. Compile o projeto.

Voltar para o início

Implantar o identificador

1. Crie um novo diretório chamado Handler no diretório C:\Inetpub\Wwwroot.
2. Crie um subdiretório chamado Bin no diretório Handler recém-criado. O caminho resultante será C:\Inetpub\Wwwroot\Handler\Bin.
3. Copie o arquivo MyHandler.dll do diretório Bin do projeto para o diretório C:\Inetpub\Wwwroot\Handler\Bin.
4. Siga estas etapas para marcar o novo diretório Handler como um aplicativo da Web:
   1. Abra o Gerenciador do Internet Services.
   2. Clique com o botão direito do mouse no diretório Handler e, em seguida, clique em Properties.
   3. Na guia Directory, clique em Create.
5. Siga estas etapas para criar um mapeamento de aplicativo para o identificador. Nesse identificador, crie um mapeamento para o arquivo Aspnet_isapi.dll da extensão *.sync. Sempre que um arquivo .sync for solicitado, a solicitação será roteada para o ASP.NET e este executará o código no identificador.
   1. Clique com o botão direito do mouse no aplicativo de identificador da Web e, em seguida, clique em Properties.
   2. Na guia Directory, clique em Configuration.
   3. Clique em Add para adicionar um novo mapeamento.
   4. Na caixa de texto Executable, digite o seguinte caminho:
      C:\WINNT\Microsoft.NET\Framework\< Número_da_versão >\Aspnet_isapi.dll
   5. Na caixa de texto Extension, digite .sync.
   6. Certifique-se de que a caixa de seleção Check that file exists está desmarcada e clique em OK para fechar a caixa de diálogo Add/Edit Application Extension Mapping.
   7. Clique em OK para fechar as caixas de diálogo Application Configuration e Handler Properties.
6. Feche o Gerenciador do Internet Services.

Voltar para o início

Configurar o sistema

1. No diretório C:\Inetpub\Wwwroot\Handler, crie um novo arquivo chamado Web.config.
2. Adicione o seguinte código ao Web.config:

   <configuration>
      <system.web>
         <httpHandlers>
            <add verb="*" path="*.sync" type="MyHandler.SyncHandler, MyHandler" />
         </httpHandlers>
      </system.web>
   </configuration>

   No atributo verb="*", instruímos o identificador a processar uma solicitação que use qualquer verbo (por exemplo, POST, HEAD, GET e assim por diante). Se você quiser que o identificador processe somente a solicitação POST, altere esse atributo para verb="POST".
   
   No atributo path="*.sync", instruímos o identificador a processar quaisquer solicitações recebidas para arquivos com a extensão .sync.
   
   No atributo type="MyHandler.SyncHander, MyHandler", instruímos o identificador que processa a solicitação a implementar o espaço para nome MyHandler.SyncHandler e esta classe residirá na sub-rotina MyHandler.

Voltar para o início

Testar o módulo

Hello from custom handler.

Voltar para o início

REFERÊNCIAS

Voltar para o início