sectionGroup elemento para configSections (Geral Settings esquema)

Artigo
08/25/2010

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

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

<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	Necessário String atributo. Especifica o nome do elemento que está associado com o manipulador de seção de configuração especificado pelo ou seção de configuraçãotype atributo. Este é o nome do group elemento sistema autônomo ele aparece na área de configurações de seção do arquivo de configuração.
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 estã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 de versão no exemplo de código a seguir 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 ser localizado no mesmo diretório do aplicativo de Web. arquivo de configuração que define a ele. No caso do Web.config raiz ou computador arquivo de configuração, o arquivo do assembly deve estar no %SystemRoot%\Microsoft.NET\estrutura\ versão diretório.

Atributo

Descrição

name

Necessário String atributo.

Especifica o nome do elemento que está associado com o manipulador de seção de configuração especificado pelo ou seção de configuraçãotype atributo. Este é o nome do group elemento sistema autônomo ele aparece na área de configurações de seção do arquivo de configuração.

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 estã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 de versão no exemplo de código a seguir 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 ser localizado no mesmo diretório do aplicativo de Web. arquivo de configuração que define a ele. No caso do Web.config raiz ou computador arquivo de configuração, o arquivo do assembly deve estar no %SystemRoot%\Microsoft.NET\estrutura\ versão diretório.

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 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

The sectionGroup elemento atua sistema autônomo um contêiner 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 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 classe que manipula o elemento ou seção de configuração. The section elementos podem ser agrupados logicamente em sectionGroup elementos para organizar o section elementos e para 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 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, ASP.NET emitirá o servidor de erro "a seção de configuração desconhecidoelement_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 agrupar de seções e declarar seções dentro de um agrupar de seções.

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

Consulte também