Partilhar via

<elemento de secção>

  • Artigo

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.

Ver também