Compartilhar via

Adicionar elemento httpModules (ASP.NET Configurações Schema)

  • Artigo

Adiciona um httpModules elemento para um aplicativo.

<add name="ModuleName"
   type=".NET Class, Assembly [,Version=version number]
      [,Culture=culture] [,PublicKeyToken=token]"/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo

Descrição

name

Atributo obrigatório.

Fornece um nome amigável para o módulo, que permite associar um manipulador de eventos para eventos de módulo dentro do arquivo global. asax.

type

Atributo obrigatório.

Especifica uma combinação de classe/montagem separada por vírgulas, constituída de versão, cultura e símbolos de chave pública. ASP.NET procura o assembly DLL primeiramente no diretório \bin particular para a aplicação e no cache de assembly do sistema.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento de raiz em todos os arquivos de configuração que é usado pelo Common Language Runtime e os aplicativos .NET Framework.

system.web

Especifica o elemento raiz para o ASP.Seção de configuração de rede.

httpModules

Configura os módulos HTTP que estão dentro de um aplicativo.

Comentários

O add diretivas são processadas em ordem seqüencial, de cima para baixo. Se dois ou mais add submarcas especificarem a mesma combinação de verbo/caminho, o final add substituirá todas as outras.

Configuração padrão

O seguinte padrão add elemento é configurado no arquivo Machine. config na.NET Framework versão 1.1.

<add name="OutputCache" type="System.Web.Caching.OutputCacheModule"/>
<add name="Session" type="System.Web.SessionState.SessionStateModule"/>
<add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule"/>
<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule"/>
<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule"/>
<add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule"/>
<add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule"/>
<add name="ErrorHandlerModule" type="System.Web.Mobile.ErrorHandlerModule, System.Web.Mobile, 
     Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>

O seguinte padrão add elemento é configurado no arquivo Machine. config na.NET Framework versão 1.0.

<add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />
<add name="Session" type="System.Web.SessionState.SessionStateModule" />
<add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />
<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
<add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />
<add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" />

O seguinte padrão add elemento é configurado no arquivo Web. config raiz na.NET Framework versão 2.0.

<add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />
<add name="Session" type="System.Web.SessionState.SessionStateModule" />
<add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />
<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
<add name="RoleManager" type="System.Web.Security.RoleManagerModule" />
<add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />
<add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" />
<add name="AnonymousIdentification" type="System.Web.Security.AnonymousIdentificationModule" />
<add name="Profile" type="System.Web.Profile.ProfileModule" />

Exemplo

O exemplo de código a seguir demonstra como adicionar um httpModules elemento para um aplicativo.

<configuration>
   <system.web>
      <httpModules>
         <add name="OutputCache"
              type="System.Web.Caching.OutputCacheModule, System.Web,
                    Version=1.0.2800.0, Culture=neutral,
                    PublicKeyToken=b03f5f7f11d50a3a"/>
      </httpModules>
   <system.web>
</configuration>

Informações do elemento

Manipulador da seção de configuração

System.Web.Configuration.HttpModulesSection

Membro de configuração

SystemWebSectionGroup.HttpModules

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Virtual ou física directory–level Web. config

Requisitos

De da (IIS) versão 5.0, 5.1 ou 6.0

A.NET Framework versão 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tarefas

Como: Bloquear definições de configuração ASP.NET

Referência

httpModules Element (ASP.NET Settings Schema)

system.web Element (ASP.NET Settings Schema)

<configuration> Element

Desmarque elemento httpModules (ASP.NET Configurações Schema)

remover o elemento httpModules (ASP.NET Configurações Schema)

System.Configuration

System.Web.Configuration

Conceitos

Visão geral da configuração ASP.NET

Controles de servidor Web do ASP.NET e recursos do navegador

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

Arquivos de configuração ASP.NET

ASP.NET Configuration Settings

General Configuration Settings (ASP.NET)

API de Configuração do ASP.NET