configSections elemento (Geral Settings esquema)

Artigo
08/25/2010

Especifica o espaço para nome e a seção declarações de configuração.

configuração elemento (Geral Settings esquema)
configSections elemento (Geral Settings esquema)

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

Elemento	Descrição
clear	Remove todas as referências a herdadas de seções e grupos de seções, permitindo que apenas as seções e grupos de seções que são adicionados pelo corrente seção and sectionGroup elementos.
remove	Remove uma referência a uma seção herdada e agrupar de seção.
section	Define uma associação entre um manipulador de seção de configuração e um elemento de configuração.
sectionGroup	Define uma associação entre um manipulador de seção de configuração e uma seção de configuração.

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.

Comentários

The configSections elemento Especifica a configuração de seção e o manipulador de declarações. 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 associada ConfigurationSection-classe que manipula o elemento ou seção de configuração derivada. The section elementos podem ser agrupados logicamente em sectionGroup elementos para organizar osection elementos e para evitar conflitos de nomes. The section e sectionGroup elementos estão contidos na configSections elemento.

Se o configSections elemento está em um arquivo de configuração, o configSections elemento deve ser o primeiro elemento filho das configuration elemento.

Configuração padrão

Seções de configuração para os elementos de configuração do .NET são definidas na computador. arquivo de configuração 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 as 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	ConfigurationSectionCollection ConfigurationSectionGroupCollection
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) versão 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

Compartilhar via