ID do artigo: 307985 - �ltima revis�o: sexta-feira, 23 de fevereiro de 2007 - Revis�o: 3.5

INFO: Vis�o geral de manipuladores HTTP e m�dulos HTTP ASP.NET

Clique aqui para exibir o artigo traduzido e o artigo original em ingl�s, lado a lado.

Exibir Aviso de Isen��o de Tradu��o Autom�tica

Exibir os produtos aos quais esse artigo se aplica.

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.

Sum�rio

Este artigo fornece uma introdu��o ao HTTP ASP.NET m�dulos e manipuladores HTTP.

Para adicionais vis�es gerais sobre ASP.NET, consulte o seguinte artigo:

305140� (http://support.microsoft.com/kb/305140/EN-US/ ) INFO: Guia de ASP.NET

Voltar para o in�cio

M�dulos HTTP e manipuladores HTTP s�o uma parte integral da arquitetura do ASP.NET. Enquanto uma solicita��o est� sendo processada, cada solicita��o � processada por v�rios m�dulos HTTP (por exemplo, o m�dulo de autentica��o e o m�dulo de sess�o) e, em seguida, � processada por um �nico manipulador HTTP. Depois que o manipulador de tiver processado a solicita��o, a solicita��o flui volta atrav�s de HTTP m�dulos.

Este artigo est� dividido em se��es a seguir:

HTTP Modules
HTTP Handlers
- Configuring HTTP Handlers
- Creating HTTP Handlers

Voltar para o in�cio

HTTP Modules

M�dulos s�o denominados antes e depois executa o manipulador. M�dulos permitem que os desenvolvedores interceptar, participar ou modificar cada solicita��o individual. M�dulos implementam a interface IHttpModule , que � localizada no namespace System.Web .

Available Events

Uma classe HttpApplication fornece um n�mero de eventos com o qual podem sincronizar m�dulos. Os eventos a seguir est�o dispon�veis para os m�dulos sincronizar com cada solicita��o. Esses eventos est�o listados em ordem seq�encial:

BeginRequest : solicita��o foi iniciada. Se voc� precisar fazer alguma coisa no in�cio de uma solicita��o (por exemplo, exibi��o an�ncio faixas na parte superior de cada p�gina), sincronize este evento.
AuthenticateRequest : se voc� deseja conectar em seu pr�prio esquema de autentica��o personalizada (por exemplo, pesquisar de um usu�rio em um banco de dados para validar a senha), criar um m�dulo que sincroniza esse evento e autentica o usu�rio como voc� deseja.
AuthorizeRequest : O evento � usado internamente para implementar mecanismos de autoriza��o (por exemplo, para armazenar suas listas de controle de acesso (ACLs) em um banco de dados em vez do sistema de arquivos). Embora voc� pode substituir esse evento, n�o existem v�rios bons motivos para fazer isso.
ResolveRequestCache : O evento determina se uma p�gina pode ser atendida da sa�da cache. Se voc� deseja gravar seu pr�prio cache de m�dulo (por exemplo, cache de compila��o um baseado em arquivo em vez de um cache de mem�ria), sincronize esse evento para determinar se deve atender a p�gina do cache.
AcquireRequestState : estado de sess�o � recuperado do armazenamento de estado. Se voc� quiser criar seu pr�prio m�dulo de gerenciamento de estado, sincronize esse evento para capturar o estado de sess�o do seu armazenamento de estado.
PreRequestHandlerExecute : O evento ocorre antes do manipulador HTTP � executado.
PostRequestHandlerExecute : O evento ocorre depois que o manipulador HTTP � executado.
ReleaseRequestState : o estado da sess�o � armazenado novamente no armazenamento de estado. Se voc� estiver criando um m�dulo de estado de sess�o personalizado, voc� deve armazenar seu estado novamente no armazenamento de estado.
UpdateRequestCache : O evento grava sa�da para o cache de sa�da. Se voc� estiver criando um m�dulo do cache personalizado, voc� gravar novamente em seu cache a sa�da.
EndRequest : solicita��o foi conclu�da. Talvez queira criar um m�dulo de depura��o que re�ne informa��es em toda a solicita��o e, em seguida, grava as informa��es para a p�gina.

Os eventos a seguir est�o dispon�veis para os m�dulos sincronizar com para cada solicita��o de transmiss�o. A ordem desses eventos � n�o-determin�stica.

PreSendRequestHeaders : O evento ocorre antes dos cabe�alhos s�o enviados. Se voc� quiser adicionar cabe�alhos adicionais, voc� pode sincronizar este evento a partir um m�dulo personalizado.
PreSendRequestContent : O evento ocorre quando o m�todo Response.Flush � chamado. Se voc� deseja adicionar conte�do adicional, voc� pode sincronizar este evento a partir um m�dulo personalizado.
erro : O evento ocorre quando ocorre uma exce��o n�o tratada. Se voc� deseja gravar um m�dulo de manipulador de erro personalizadas, sincronize este evento.

Configuring HTTP Modules

O manipulador de se��o de configura��o <httpmodules> � respons�vel por configurar os m�dulos HTTP em um aplicativo. Ela pode ser declarada no computador, site ou n�vel de aplicativo. Use a seguinte sintaxe para o manipulador de se��o <httpmodules>:

<httpModules>
   <add type="[COM+ Class], [Assembly]" name="[ModuleName]" />
   <remove type="[COM+ Class], [Assembly]" name="[ModuleName]" />
   <clear />
</httpModules>

Creating HTTP Modules

Para criar um m�dulo HTTP, voc� deve implementar a interface IHttpModule . A interface IHttpModule tem dois m�todos com as seguintes assinaturas:

void Init(HttpApplication);
void Dispose();

Para obter informa��es adicionais sobre como criar m�dulos HTTP, clique nos n�meros abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:

308000� (http://support.microsoft.com/kb/308000/EN-US/ ) COMO: Criar um m�dulo de HTTP do ASP.NET usando o Visual Basic .NET

307996� (http://support.microsoft.com/kb/307996/EN-US/ ) COMO: Criar um m�dulo de HTTP do ASP.NET usando o Visual translation from VPE for Csharp .NET

Voltar para o in�cio

HTTP Handlers

Manipuladores s�o usados para processar solicita��es de ponto de extremidade individuais. Manipuladores de ativar a estrutura ASP.NET processar URLs HTTP individuais ou grupos de extens�es de URL em um aplicativo. Ao contr�rio dos m�dulos, apenas um manipulador � usado para processar uma solicita��o. Todos os manipuladores implementam a interface IHttpHandler , que � localizada no namespace System.Web . Manipuladores s�o um pouco an�logos ao servidor de Internet extens�es ISAPI (Application Programming Interface).

Configuring HTTP Handlers

O manipulador de se��o de configura��o <httphandlers> � respons�vel por mapeamento de URLs de entrada para oclasse IHttpHandlerFactory ou IHttpHandler . Ela pode ser declarada no computador, site ou n�vel de aplicativo. Subdiret�rios herdam essas configura��es.

Os administradores usam a diretiva de marca <add> para configurar a se��o <httphandlers>. <add> diretivas s�o interpretadas e processadas em uma ordem seq�encial de cima para baixo. Use a seguinte sintaxe para o manipulador de se��o <httphandler>:

<httpHandlers>
   <add verb="[verb list]" path="[path/wildcard]" type="[COM+ Class], [Assembly]" validate="[true/false]" />
   <remove verb="[verb list]" path="[path/wildcard]" />
   <clear />
</httpHandlers>

Creating HTTP Handlers

Para criar um manipulador HTTP, voc� deve implementar a interface IHttpHandler . A interface IHttpHandler tem um m�todo e uma propriedade com as seguintes assinaturas:

void ProcessRequest(HttpContext);
bool IsReusable {get;}

Observa��o : se o estado da sess�o for necess�ria no seu manipulador HTTP, voc� tamb�m precisar� implementar a interface IRequiresSessionState . Para obter informa��es adicionais sobre como criar manipuladores HTTP, clique nos n�meros abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:

308001� (http://support.microsoft.com/kb/308001/EN-US/ ) COMO: Criar um manipulador de HTTP do ASP.NET usando o Visual translation from VPE for Csharp .NET

Para obter informa��es adicionais, clique nos n�meros abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:

307997� (http://support.microsoft.com/kb/307997/EN-US/ ) COMO: Criar um manipulador de HTTP do ASP.NET usando o Visual Basic .NET

Voltar para o in�cio

A informa��o contida neste artigo aplica-se a:

Microsoft ASP.NET 1.1
Microsoft ASP.NET 1.0

Voltar para o in�cio

kbmt kbarttyperoadmap kbhttphandlers kbhttpmodule kbhttpruntime kbinfo KB307985 KbMtpt

Voltar para o in�cio

Tradu��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 traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplica��es (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em portugu�s a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradu��o autom�tica n�o � sempre perfeita, podendo conter erros de vocabul�rio, sintaxe ou gram�tica. A Microsoft n�o � respons�vel por incoer�ncias, erros ou preju�zos ocorridos em decorr�ncia da utiliza��o dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualiza��es freq�entes ao software de tradu��o autom�tica (MT). Obrigado.

Clique aqui para ver a vers�o em Ingl�s deste artigo: 307985� (http://support.microsoft.com/kb/307985/en-us/ )

Voltar para o in�cio

This site in other countries/regions:

INFO: Vis�o geral de manipuladores HTTP e m�dulos HTTP ASP.NET

Nesta p�gina

Sum�rio

Mais Informa��es

HTTP Modules

Available Events

Configuring HTTP Modules

Creating HTTP Modules

HTTP Handlers

Configuring HTTP Handlers

Creating HTTP Handlers

A informa��o contida neste artigo aplica-se a:

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Obtenha Ajuda Agora

Tradu��es deste artigo