<section> elemento

Contém uma declaração de seção de configuração.

<configuration>
  <configSections>
    <section>

<configuration>
  <configSections>
    <sectionGroup>
      <section>

Sintaxe

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

Atributos necessários

Attribute	Description
name	Especifica o nome da seção de configuração.
type	Especifica o nome da classe de manipulador de seção de configuração que lê a seção do arquivo de configuração. O valor do tipo tem a sintaxe "fully-qualified-section-handler-class-name, simple-assembly-name". O nome do assembly simples é o nome do arquivo raiz sem a extensão de arquivo.dll .

Atributos opcionais

Os atributos a seguir são aplicáveis somente para aplicativos ASP.NET. O sistema de configuração ignora esses atributos para outros tipos de aplicativo.

Atributo opcional	Description
allowDefinition	Especifica em qual arquivo de configuração a seção pode ser usada. Use um dos valores a seguir: Em toda parte Permite que a seção seja usada em qualquer arquivo de configuração. Esse é o padrão. MachineOnly Permite que a seção seja usada apenas no arquivo de configuração do computador (Machine.config). MachineToApplication Permite que a seção seja usada no arquivo de configuração do computador ou no arquivo de configuração do aplicativo.
allowLocation	Determina se a seção pode ser usada dentro do <location> elemento. Use um dos valores a seguir: verdadeiro Permite que a seção seja usada dentro do <location> elemento. Esse é o padrão. falso Não permite que a seção seja usada dentro do <location> elemento.

Elementos pai

Elemento pai	Description
<configSections>	Contém a seção de configuração e declarações de namespace.
<sectionGroup>	Define um namespace para seções de configuração.

Observação

Um <section> elemento é um elemento filho de ambos <configSections> ou <sectionGroup> não.

Elementos filho

None

Observações

Declarar uma seção de configuração essencialmente define um novo elemento para o arquivo de configuração. O novo elemento contém configurações que um manipulador de seção de configuração (ou seja, uma classe que implementa a IConfigurationSectionHandler interface) lê. Os atributos e os elementos filho de uma seção que você define dependem do manipulador de seção que você usa para ler suas configurações.

Declarar um manipulador de seção de configuração no arquivo Machine.config permite que você use a seção de configuração em qualquer arquivo de configuração de aplicativo nesse computador, a menos que o atributo especifique o allowDefinition contrário.

Example

O exemplo a seguir mostra como definir uma seção de configuração e definir as configurações dessa seção:

<configuration>
  <configSections>
    <section name="sampleSection"
             type="System.Configuration.SingleTagSectionHandler"
             allowLocation="false" />
  </configSections>
  <sampleSection setting1="Value1"
                 setting2="value two"
                 setting3="third value" />
</configuration>

Arquivo de configuração

Esse elemento pode ser usado no arquivo de configuração do aplicativo, no arquivo de configuração do computador (Machine.config) e Web.config arquivos que não estão no nível do diretório do aplicativo.

Consulte também

• Esquema de arquivo de configuração para o .NET Framework