configSections Element (General Settings Schema)

Artigo
05/28/2012

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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

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

Attributes and Elements

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

Attributes

Nenhum.

Child Elements

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 atual seção e sectionGroup elementos.
remove	Remove uma referência a uma seção herdada e o grupo de seções.
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.

Parent Elements

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

Remarks

O configSections elemento especifica declarações de manipulador e de seção de configuraçã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 elemento e o tipo de ConfigurationSection-que lida com a seção de configuração ou o elemento classe derivada. O section elementos podem ser agrupados logicamente em sectionGroup elementos para organizar o section elementos e para evitar conflitos de nomes. O section e sectionGroup elementos estão contidos no configSections elemento.

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

Configuração padrão

Seções de configuração para o.Elementos de configuração de rede 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 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 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>

Element Information

Manipulador da seção de configuração	Não é válido.
Membro de configuração	ConfigurationSectionCollection ConfigurationSectionGroupCollection
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Directory–level virtuais ou físicas Web. config
Requisitos	Serviços de Informações da Internet da Microsoft (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