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

Traduções deste artigo Traduções deste artigo
ID do artigo: 308001 - Exibir os produtos aos quais esse artigo se aplica.
Este artigo foi publicado anteriormente em BR308001
Expandir tudo | Recolher tudo

Neste artigo

Sumário

Este artigo passo a passo demonstra como usar o Visual C# .NET para criar um identificador HTTP simples e personalizado. Este artigo explica como criar, implantar e configurar o identificador.

Implementar o identificador

  1. Abra o Microsoft Visual Studio .NET. No Visual C# .NET, crie um projeto de biblioteca de classes chamado MyHandler.
  2. Defina uma referência à sub-rotina System.Web.dll.
  3. Adicione a seguinte diretiva à classe:
    using 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 : 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 bool IsReusable
    {
       get {return false;}
    }
    
    public void ProcessRequest(HttpContext context)
    {
       context.Response.Write("Hello from custom handler.");
    }
  7. Compile o projeto.

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\Debug 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 emOK para fechar as caixas de diálogo Application Configuration e Handler Properties.
  6. Feche o Gerenciador do Internet Services.

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ê deseja 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.

Testar o módulo

Para testar um identificador, não é necessário que haja uma página no sistema de arquivos. Por exemplo, solicite o arquivo Default.sync no aplicativo de identificador da Web (http://< Nomedocomputador >/Handler/Default.sync). Você receberá os seguintes resultados:
Hello from custom handler.

REFERÊNCIAS

Para obter informações adicionais sobre identificadores HTTP, clique no número do artigo a seguir para exibi-lo no Microsoft Knowledge Base:
307985 BETA-INFO: ASP.NET HTTP Modules and HTTP Handlers Overview













Propriedades

ID do artigo: 308001 - Última revisão: quarta-feira, 9 de abril de 2003 - Revisão: 2.0
A informação contida neste artigo aplica-se a:
  • Microsoft ASP.NET Beta 2
  • Microsoft Visual C# .NET 2002 Standard Edition
Palavras-chave: 
kbhowto kbhowtomaster kbhttpruntime kbgrpdsasp KB308001

Submeter comentários

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com