elemento de > de seção <<section> element

Contém uma declaração de seção de configuração.Contains a configuration section declaration.

<configuration> <configuration>
   <configsections >   <configSections>
     <seção >    <section>

<configuration> <configuration>
   <configsections >   <configSections>
   **  <o > **     <sectionGroup>
      seção<      <section>

SintaxeSyntax

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

Atributos necessáriosRequired attributes

DescriçãoDescription
namename Especifica o nome da seção de configuração.Specifies the name of the configuration section.
typetype Especifica o nome da classe de manipulador da seção de configuração que lê a seção do arquivo de configuração.Specifies the name of the configuration section handler class that reads the section from the configuration file. O valor do tipo tem a sintaxe "totalmente qualificado-section-Handle-Class-Name, Simple-Assembly-Name".The type value has the syntax "fully-qualified-section-handler-class-name, simple-assembly-name". O nome do assembly simples é o nome de arquivo raiz sem a extensão de arquivos . dll .The simple assembly name is the root filename without the .dll file extension.

Atributos opcionaisOptional attributes

Os atributos a seguir são aplicáveis somente para aplicativos ASP.NET.The following attributes are applicable only for ASP.NET applications. O sistema de configuração ignora esses atributos para outros tipos de aplicativos.The configuration system ignores these attributes for other application types.

DescriçãoDescription
allowDefinitionallowDefinition Especifica em qual arquivo de configuração a seção pode ser usada.Specifies which configuration file the section can be used in. Use um dos seguintes valores:Use one of the following values:

ParteEverywhere
Permite que a seção seja usada em qualquer arquivo de configuração.Allows the section to be used in any configuration file. Esse é o padrão.This is the default.
MachineOnlyMachineOnly
Permite que a seção seja usada somente no arquivo de configuração da máquina (Machine. config).Allows the section to be used only in the machine configuration file (Machine.config).
MachineToApplicationMachineToApplication
Permite que a seção seja usada no arquivo de configuração do computador ou no arquivo de configuração do aplicativo.Allows the section to be used in the machine configuration file or the application configuration file.
allowLocationallowLocation Determina se a seção pode ser usada dentro do elemento <local > .Determines whether the section can be used within the <location> element. Use um dos seguintes valores:Use one of the following values:

truetrue
Permite que a seção seja usada dentro do elemento <local > .Allows the section to be used within the <location> element. Esse é o padrão.This is the default.
falsefalse
Não permite que a seção seja usada dentro do elemento <local > .Does not allow the section to be used within the <location> element.

Elementos paiParent elements

DescriçãoDescription
<configsections > Elementos<configSections> Element Contém as declarações de namespace e seção de configuração.Contains configuration section and namespace declarations.
<> de seção Elementos<sectionGroup> Element Define um namespace para seções de configuração.Defines a namespace for configuration sections.

Observação

Um elemento de > de seção< é um elemento filho de <configSections > ou<o > de seção , mas não ambos.A <section> element is a child element of either <configSections> or <sectionGroup> but not both.

Elementos filhoChild elements

NenhumNone

ComentáriosRemarks

Declarar uma seção de configuração essencialmente define um novo elemento para o arquivo de configuração.Declaring a configuration section essentially defines a new element for the configuration file. O novo elemento contém configurações que um manipulador de seção de configuração (ou seja, uma classe que implementa a interface de IConfigurationSectionHandler) lê.The new element contains settings that a configuration section handler (that is, a class that implements the IConfigurationSectionHandler interface) reads. 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.The attributes and child elements of a section you define depend on the section handler you use to read your settings.

A declaração de 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.Declaring a configuration section handler in the Machine.config file enables you to use the configuration section in any application configuration file on that computer, unless the allowDefinition attribute specifies otherwise.

ExemploExample

O exemplo a seguir mostra como definir uma seção de configuração e definir as configurações para essa seção:The following example shows how to define a configuration section and define settings for that section:

<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çãoConfiguration file

Esse elemento pode ser usado no arquivo de configuração do aplicativo, no arquivo de configuração do computador (Machine. config) e nos arquivos Web. config que não estão no nível do diretório do aplicativo.This element can be used in the application configuration file, machine configuration file (Machine.config), and Web.config files that are not at the application directory level.

Consulte tambémSee also