Elemento <section>
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 obrigatórios
| Descrição | |
|---|---|
| name | Especifica o nome da seção de configuração. |
| tipo | Especifica o nome da classe do manipulador da 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 a aplicativos ASP.NET. O sistema de configuração ignora esses atributos para outros tipos de aplicativo.
| Descrição | |
|---|---|
| allowDefinition | Especifica em qual arquivo de configuração a seção pode ser usada. Use um dos seguintes valores: Em todos os lugares 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 somente no arquivo de configuração do computador (Machine.config). MachineToApplication Permite que a seção seja usada no arquivo de configuração de computador ou no arquivo de configuração de aplicativo. |
| allowLocation | Determina se a seção pode ser usada dentro do elemento <location>. Use um dos seguintes valores: true Permite que a seção seja usada dentro do elemento <location>. Esse é o padrão. false Não permite que a seção seja usada dentro do elemento <location>. |
Elementos pai
| Descrição | |
|---|---|
| elemento <configSections> | Contém a seção de configuração e declarações de namespace. |
| Elemento <sectionGroup> | Define um namespace para seções de configuração. |
Observação
Um elemento <section> é um elemento filho de <configSections> ou de <sectionGroup>, mas não de ambos.
Elementos filho
Nenhum
Comentários
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 interface IConfigurationSectionHandler) 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 allowDefinition especifique o contrário.
Exemplo
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 de aplicativo, no arquivo de configuração do computador (Machine.config) e em arquivos Web.config que não estão no nível do diretório do aplicativo.
