Artigo: 307997 - Última revisão: quinta-feira, 15 de Julho de 2004 - Revisão: 3.4

Como criar um processador de HTTP do ASP.NET utilizando o Visual Basic .NET

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Reduzir tudo

Sumário

Este artigo passo a passo demonstra como utilizar o Microsoft Visual Basic .NET para criar um processador de HTTP personalizado, simples. Este artigo demonstra como criar, implementar e configurar o processador.

Implementar a rotina de tratamento

  1. Iniciar Microsoft Visual Studio. NET.
  2. Criar um novo projecto de biblioteca de classes, utilizando o Visual Basic .NET e, em seguida, nome do projecto MyHandler.
  3. Adicione uma referência à assemblagem de System.Web.dll .
  4. Adicione o seguinte código para importar o espaço de nomes System.Web :
    Imports System.Web
    					
  5. Mudar o nome da classe SyncHandler.vb e altere a definição de classe para reflectir esta.
  6. Implementa a interface IHttpHandler . A definição de classe deve aparecer da seguinte forma:
    Public Class SyncHandler
       Implements IHttpHandler
    					
  7. Implemente a propriedade IsReusable e o método ProcessRequest da interface IHttpHandler . Uma vez que esta for uma rotina de tratamento síncrona, novamente Falso para a propriedade IsReusable para que o processador não processos em pool.
    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
    					
  8. Compile o projecto.

    Nota : Se pretende que o processador para ter acesso a dados da sessão e a classe tem de implementar interface IRequiresSessionState para além do IHttpHandler . IRequiresSessionState não tem métodos ou propriedades. Apenas designa a que o processador utiliza dados de sessão.

Implementar a rotina de tratamento

  1. Crie um novo directório denominado identificador sob o directório C:\Inetpub\Wwwroot.
  2. Crie um subdirectório chamado posição no directório de rotina de tratamento de recém-criado. O caminho resultante é C:\Inetpub\Wwwroot\Handler\Bin.
  3. Copie MyHandler.dll do directório de posição do projecto para o directório C:\Inetpub\Wwwroot\Handler\Bin.
  4. Siga estes passos para marcar o directório de rotina de tratamento de novo como uma aplicação Web:
    1. No Microsoft Windows 2000 e no Microsoft Windows XP, inicie o Gestor de serviços Internet. No Windows Server 2003, inicie o Gestor dos serviços de informação Internet (IIS).
    2. Clique com o botão direito do rato no directório rotina de tratamento e, em seguida, clique em Propriedades .
    3. No separador directório , clique em criar .
  5. Siga estes passos para criar um mapeamento de aplicação para o processador. Para esta rotina de tratamento, crie um mapeamento para o ficheiro aspnet_isapi.dll extensão *.sync. Sempre que um ficheiro .Sync é pedido, o pedido é encaminhado para ASP.NET, e o ASP.NET executa o código no processador de.
    1. Clique com o botão direito do rato na aplicação Web de rotina de tratamento e, em seguida, clique em Propriedades .
    2. No separador directório , clique em configuração .
    3. Clique em Adicionar para adicionar um novo mapeamento.
    4. Na caixa de texto executável , escreva o seguinte caminho:
      C:\WINNT\Microsoft.NET\Framework\ < versão # > \Aspnet_isapi.dll
    5. Na caixa de texto extensão , escreva .Sync .
    6. No Windows 2000 e no Windows XP, certifique-se de que a caixa de verificação verificar se o ficheiro existe está desmarcada e, em seguida, clique em OK para fechar a caixa de diálogo Adicionar/editar mapeamento de extensão de aplicação . No Windows Server 2003, certifique-se de que a caixa de verificação verificar se o ficheiro existe está desmarcada e, em seguida, clique em OK para fechar a caixa de diálogo Adicionar/editar mapeamento de extensão de aplicação .
    7. Clique em OK para fechar a Configuração da aplicação e caixas de diálogo Propriedades da rotina de tratamento .
  6. Feche o Gestor de serviços Internet.

Configurar o sistema

  1. No directório C:\Inetpub\Wwwroot\Handler, crie um novo ficheiro com o nome Web.config.
  2. Adicione o seguinte código para Web.config:
    <configuration>
       <system.web>
          <httpHandlers>
             <add verb="*" path="*.sync" type="MyHandler.SyncHandler, MyHandler" />
          </httpHandlers>
       </system.web>
    </configuration>
    						
    in a verbo = "*" atributo, indicar a rotina de tratamento para processar um pedido que utilize qualquer verbo (por exemplo, POST, HEAD, GET e assim sucessivamente). Se pretender que este processador para processar apenas o pedido POST, altere esta opção para verbo = "POST" .

    No caminho = "*.sync" atributo, indicar o processador de processar quaisquer pedidos a receber ficheiros com a extensão .Sync.

    No type="MyHandler.SyncHander, MyHandler" atributo indique a rotina de tratamento que processa o pedido para implementar no espaço de nomes MyHandler.SyncHandler e esta classe reside na assemblagem MyHandler .

Testar o módulo

Para testar uma rotina de tratamento, uma página não é necessário existir no sistema de ficheiros. Por exemplo, pedir o ficheiro Default.sync na Web a rotina de tratamento de aplicações (http:// < NomeComputador > / Handler/Default.sync). Deverá receber os seguintes resultados:
Hello from custom handler.
				

Referências

Para obter informações adicionais sobre HTTP processadores, clique no número de artigo existente abaixo para visualizar o artigo na base de dados de conhecimento da Microsoft:
307985  (http://support.microsoft.com/kb/307985/EN-US/ ) INFO: Descrição geral de rotinas de tratamento HTTP e módulos HTTP do ASP.NET

A informação contida neste artigo aplica-se a:
  • Microsoft ASP.NET 1.1
  • Microsoft ASP.NET 1.0
  • Microsoft Visual Basic .NET 2003 Standard Edition
  • Microsoft Visual Basic .NET 2002 Standard Edition
Palavras-chave: 
kbmt kbconfig kbhowtomaster kbhttphandlers kbhttpruntime kbweb KB307997 KbMtpt
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine translation ou MT), não tendo sido portanto revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais. O objectivo é simples: oferecer em Português a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradução automática não é sempre perfeita. Esta pode conter erros de vocabulário, sintaxe ou gramática? erros semelhantes aos que um estrangeiro realiza ao falar em Português. A Microsoft não é responsável por incoerências, erros ou estragos realizados na sequência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualizações frequentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 307997  (http://support.microsoft.com/kb/307997/en-us/ )