Partilhar via


Elemento de seção para configSections (Geral Settings esquema)

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

configuração elemento (Geral Settings esquema)
  configSections elemento (Geral Settings esquema)
    Elemento de seção para configSections (Geral Settings esquema)
      configuração elemento (Geral Settings esquema)
        configSections elemento (Geral Settings esquema)
          sectionGroup elemento para configSections (Geral Settings esquema)
            Elemento de seção para configSections (Geral Settings esquema)

<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 a apenas aplicativos ASP.NET.

Especifica que a seção pode ser usada em do arquivo de configuração.

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

Valor Descrição
Everywhere Permite que a seção a ser configurado em qualquer configuração de arquivo ou diretório, da seguinte maneira:
  • computador.config.

  • web raiz .config.

  • Web.config para um aplicativo.

  • Diretório virtual.

  • Subdiretório físico no aplicativo.

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

  • web raiz .config.

  • Web.config para um aplicativo.

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

  • web raiz .config.

O computador.config e Web.config arquivos estão localizados em %SystemRoot%\Microsoft.NET\estrutura\ raizversionNumber \Config.
MachineOnly Permite que a seção a ser configurado somente no arquivo computador.config, localizado no %SystemRoot%\Microsoft.NET\estrutura\ versionNumber \Config.

allowExeDefinition

Opcional Enum atributo.

Aplica-se aos aplicativos de cliente do .NET estrutura somente.

Especifica que a seção pode ser usada em do arquivo de configuração.

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

Valor Descrição
MachineToApplication Permite que a seção a ser configurado em um dos seguintes arquivos:
  • computador.config.

  • Configuração de aplicativo.

MachineToRoamingUser
MachineToLocalUser
MachineOnly Permite que a seção a ser configurado somente no arquivo computador.config, localizado no %SystemRoot%\Microsoft.NET\estrutura\ versionNumber \Config.

allowLocation

Opcional Boolean atributo.

Se aplica a apenas aplicativos ASP.NET.

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

O padrão é True.

name

Necessá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çãotype atributo. Este é o nome do elemento sistema autônomo ele aparece na área de configurações de seção do arquivo de configuração.

restartOnExternalChanges

Opcional Boolean atributo.

Não se aplica a aplicativos ASP.NET.

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

type

Necessário String atributo.

Especifica o nome da classe de manipulador de seção configuração que lida com o processamento das definições de configuração na seção ou elemento que está especificado no name atributo. Use o seguinte formato:

type="Fully qualified class name, assembly file name, version, culture, public key token"

A definição deve corresponde à referência do assembly. Por exemplo, se o número da versão na seguinte sintaxe de exemplo não coincidir com o 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 do aplicativo sistema autônomo o arquivo Web.config que define o arquivo de montagem. No caso da raiz da Web. arquivo de configuração ou computador. arquivo de configuração, o arquivo do assembly deve estar no %SystemRoot%\Microsoft.NET\estrutura\ versão.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.

configSections

Especifica o espaço para nome e a seção declarações 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 o ASP.NET não facilita nenhum presumptions sobre como lidar com as configurações de dentro de um arquivo de configuração. Em vez disso, o ASP.NET delega o processamento de dados de configuração manipuladores de seção de configuração. Cada section elemento identifica uma seção de configuração ou elemento e a classe associada é derivada de ConfigurationSection que manipula o elemento ou seção de configuração. The section elementos podem ser agrupados logicamente em sectionGroup elementos de organização e para ajudar a evitar conflitos de nomes. The section e sectionGroup elementos estão contidos na configSections elemento.

Configuração padrão

Seções de configuração para os elementos de configuração do .NET estrutura são definidas no arquivo computador.config e são muito numerosas para serem listadas aqui. O seguinte trecho do arquivo computador.config define o manipulador de seção de configuração para o authentication elemento das 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 a um elemento de configuração, o ASP.NET emite o erro de servidor, seção de configuração desconhecido"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 de seção de configuração

Não se aplica.

Configuração de membro

ConfigurationSection

Locais configuráveis

Machine.config

Web.config de nível de raiz

Web.config de nível de aplicativo

Virtual ou físico diretório–nível Web.config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) 5.0, 5.1 ou 6.0

O .NET estrutura versão 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

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

Referência

configSections elemento (Geral Settings esquema)

sectionGroup elemento para configSections (Geral Settings esquema)

desmarcar elemento configSections (Geral Settings esquema)

Remover elemento configSections (Geral Settings esquema)

configuração elemento (Geral Settings esquema)

Outros recursos

Configurações gerais (ASP.NET)

Definições de configuração ASP.NET

Arquivos de configuração ASP.NET

Administrando ites da Web do ASP.NET

API de Configuração do ASP.NET