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

Artigo
08/04/2011

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

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token">
   <section />
/>

Atributos e elementos

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

Atributos

Atributo	Descrição
name	Obrigatório String atributo. Especifica o nome da seção de configuração ou o elemento que está associado com o manipulador de seção de configuração especificado pelo type atributo. Este é o nome da group elemento como ele aparece na área de configurações de seção do arquivo de configuração.
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 definições de configuração que estão 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 no exemplo de código a seguir não corresponde 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 a ele. No caso de raiz Web. config ou no arquivo Machine. config, o arquivo do assembly deve constar do %SystemRoot%\Microsoft.NET\Framework\versão directory.

Atributo

Descrição

name

Obrigatório String atributo.

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

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 definições de configuração que estão 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 no exemplo de código a seguir não corresponde 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 a ele. No caso de raiz Web. config ou no arquivo Machine. config, o arquivo do assembly deve constar do %SystemRoot%\Microsoft.NET\Framework\versão directory.

Elementos filho

Elemento	Descriçã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 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

O sectionGroup elemento atua como um recipiente para section elementos. 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 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, é derivada de ConfigurationSection classe que lida com a seção de configuração ou o elemento. O section elementos podem ser agrupados logicamente em sectionGroup elementos para organizar a section elementos e 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 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 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 emitirá 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 declarar um grupo de seção e declarar seções dentro de um grupo de seção.

<configuration>
   <configSections>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

Informações do elemento

Manipulador da seção de configuração	Não se aplica.
Membro de configuração	ConfigurationSectionGroup
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 2.0 Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Compartilhar via