Compartilhar via


seção elemento de configSections (Geral Configurações Schema)

Define uma associação entre um manipulador de seção de configuração e um elemento de configuração.

<section 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   allowDefinition= "Everywhere|MachineOnly|MachineToApplication|MachineToWebRoot" 
   allowLocation="True|False" 
   restartOnExternalChanges="True|False" 
/>

Atributos e elementos

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

Atributos

Atributo

Descrição

allowDefinition

Opcional Enum atributo.

Se aplica ao ASP.NET applications apenas.

Especifica a seção pode ser usada no arquivo de configuração.

Esse atributo pode ser um dos seguintes valores (definidos no ConfigurationAllowDefinition enumeração) em ordem decrescente de escopo.

ValorDescrição
Everywhere Permite que a seção a ser configurado em qualquer arquivo de configuração ou o diretório, como segue:
  • Machine. config.

  • Web. config da raiz.

  • Web. config para um aplicativo.

  • Diretório virtual.

  • Subdiretório físico no aplicativo.

Se nenhum allowDefinition atributo é usado, Everywhere é assumido.Este é o padrão.
MachineToApplication Permite que a seção a ser configurado em um dos seguintes arquivos:
  • Machine. config.

  • Web. config da raiz.

  • Web. config para um aplicativo.

Isso exclui os arquivos Web. config em diretórios virtuais ou em um subdiretório físico no aplicativo.
MachineToWebRoot Permite que a seção a ser configurado em um dos seguintes arquivos:
  • Machine. config.

  • Web. config da raiz.

Tanto o Machine. config raiz Web. config arquivos estão localizados em %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG.
MachineOnly Permite que a seção a ser configurado apenas no arquivo Machine. config, que está localizado em %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG.

allowExeDefinition

Opcional Enum atributo.

Se aplica.NET Framework cliente apenas para aplicativos.

Especifica a seção pode ser usada no arquivo de configuração.

Esse atributo pode ser um dos seguintes valores (definidos no ConfigurationAllowExeDefinition enumeração) em ordem decrescente de escopo.

ValorDescrição
MachineToApplication Permite que a seção a ser configurado em um dos seguintes arquivos:
  • Machine. config.

  • Configuração do aplicativo.

MachineToRoamingUser
MachineToLocalUser
MachineOnly Permite que a seção a ser configurado apenas no arquivo Machine. config, que está localizado em %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG.

allowLocation

Opcional Boolean atributo.

Se aplica ao ASP.NET applications apenas.

Especifica se a seção pode ser usada dentro do local elemento.

O padrão é True.

name

Obrigatório String atributo.

Especifica o nome do elemento que está associado com o manipulador de seção de configuração especificado no ou seção de configuração do type atributo. Este é o nome do elemento, como ele aparece na área de configurações de seção do arquivo de configuração.

restartOnExternalChanges

Opcional Boolean atributo.

Não se aplica ao ASP.NET applications.

Especifica se deve reiniciar o aplicativo, se os dados de configuração para a seção for alterado.

type

Obrigatório String atributo.

Especifica o nome do que a classe de manipulador de seção de configuração que manipula o processamento das configurações na seção ou do elemento especificado no name atributo. Use o seguinte formato:

type="Nome totalmente qualificado da classe, nome de arquivo do assembly, versão, cultura, o token de chave pública"

A definição deve coincidir com a referência do assembly. Por exemplo, se o número de versão na seguinte sintaxe de exemplo não corresponder ao assembly, ocorrerá um erro.

type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

O arquivo do assembly deve estar localizado no mesmo diretório de aplicativo do arquivo Web. config que define o arquivo do assembly. No caso de arquivo raiz Web. config ou no arquivo Machine. config, o arquivo de assembly deve estar em %SystemRoot%\Microsoft.NET\Framework\versão.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.

configSections

Especifica as declarações de namespace e de seção de configuração.

sectionGroup

Define uma associação entre um manipulador de seção de configuração e uma seção de configuração.

Comentários

A section elemento associa um manipulador de seção de configuração com um elemento de configuração ou seção. Isso é necessário porque ASP.NET não torna nenhuma presumptions sobre como lidar com configurações dentro de um arquivo de configuração. Em vez disso, ASP.NET delega o processamento de dados de configuração para manipuladores de seção de configuração. Cada section elemento identifica uma seção de configuração ou o elemento e a classe associada, que é derivada de ConfigurationSection que lida com a seção de configuração ou o elemento. O section elementos podem ser agrupados logicamente em sectionGroup elementos para a organização e para ajudar a evitar a nomeação de conflitos. O section e sectionGroup elementos estão contidos no configSections elemento.

Configuração padrão

Seções de configuração para o.Elementos de configuração do NET Framework são definidos no arquivo Machine. config e são muito numerosas para listar aqui. O seguinte trecho do arquivo Machine. config define o manipulador de seção de configuração para o authentication o elemento da system.web seção. Em seguida, as configurações são definidas para o authentication elemento.

Se um manipulador de seção de configuração não está associado um elemento de configuração, o ASP.NET emite o erro de servidor "não reconhecido a seção de configuração element_name."

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

Exemplo

O exemplo de código a seguir mostra como definir uma seção de configuração personalizada e definir configurações para essa seção.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

Informações do elemento

Manipulador da seção de configuração

Não se aplica.

Membro de configuração

ConfigurationSection

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 Serviços de Informações da Internet da Microsoft (IIS) 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

Referência

configSections Element (Geral Configurações Schema)

sectionGroup elemento para configSections (Geral Configurações Schema)

Desmarque elemento configSections (Geral Configurações Schema)

remover o elemento configSections (Geral Configurações Schema)

configuração Element (Geral Configurações Schema)

Conceitos

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Editando Arquivos de Configuração ASP.NET

Cenários de configuração ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Arquivos de configuração ASP.NET

Administração de Sites do ASP.NET

API de Configuração do ASP.NET