<elemento de secção>
Contém uma declaração de secção de configuração.
<configuração>
<configSections>
<secção>
<configuração>
<configSections>
<sectionGroup>
<secção>
Syntax
<section name="section name"
type="configuration section handler class, assembly"
allowDefinition="Everywhere|MachineOnly|MachineToApplication"
allowLocation="true|false" />
Atributos necessários
| Description | |
|---|---|
| nome | Especifica o nome da secção de configuração. |
| tipo | Especifica o nome da classe de processador de secções de configuração que lê a secção do ficheiro de configuração. O valor do tipo tem a sintaxe "fully-qualified-section-handler-class-name, simple-assembly-name". O nome da assemblagem simples é o nome de ficheiro de raiz sem a extensão de ficheiro.dll . |
Atributos opcionais
Os seguintes atributos são aplicáveis apenas para aplicações ASP.NET. O sistema de configuração ignora estes atributos para outros tipos de aplicações.
| Description | |
|---|---|
| allowDefinition | Especifica em que ficheiro de configuração a secção pode ser utilizada. Utilize um dos seguintes valores: Em todo o lado Permite que a secção seja utilizada em qualquer ficheiro de configuração. Esta é a predefinição. MachineOnly Permite que a secção seja utilizada apenas no ficheiro de configuração do computador (Machine.config). MachineToApplication Permite que a secção seja utilizada no ficheiro de configuração do computador ou no ficheiro de configuração da aplicação. |
| allowLocation | Determina se a secção pode ser utilizada no <elemento de localização> . Utilize um dos seguintes valores: verdadeiro Permite que a secção seja utilizada no <elemento de localização> . Esta é a predefinição. falso Não permite que a secção seja utilizada no <elemento de localização> . |
Elementos principais
| Description | |
|---|---|
| <elemento configSections> | Contém a secção de configuração e as declarações de espaço de nomes. |
| <sectionGroup> Element | Define um espaço de nomes para secções de configuração. |
Nota
Um <elemento de secção> é um elemento subordinado de <configSections> ou <sectionGroup> , mas não ambos.
Elementos subordinados
Nenhum
Observações
Declarar uma secção de configuração define essencialmente um novo elemento para o ficheiro de configuração. O novo elemento contém definições que um processador de secções de configuração (ou seja, uma classe que implementa a IConfigurationSectionHandler interface) lê. Os atributos e elementos subordinados de uma secção que definir dependem do processador de secções que utiliza para ler as suas definições.
Declarar um processador de secção de configuração no ficheiro Machine.config permite-lhe utilizar a secção de configuração em qualquer ficheiro de configuração da aplicação nesse computador, a menos que o atributo allowDefinition especifique o contrário.
Exemplo
O exemplo seguinte mostra como definir uma secção de configuração e definir definições para essa secção:
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler"
allowLocation="false" />
</configSections>
<sampleSection setting1="Value1"
setting2="value two"
setting3="third value" />
</configuration>
Ficheiro de configuração
Este elemento pode ser utilizado no ficheiro de configuração da aplicação, no ficheiro de configuração do computador (Machine.config) e Web.config ficheiros que não estão ao nível do diretório da aplicação.
