sectionGroup elemento para configSections (Geral Settings esquema)
Define uma associação entre um manipulador de seção de configuração e uma seção de configuração.
configuração elemento (Geral Settings esquema)
configSections elemento (Geral Settings esquema)
sectionGroup elemento para configSections (Geral Settings esquema)
configuração elemento (Geral Settings esquema)
configSections elemento (Geral Settings esquema)
sectionGroup elemento para configSections (Geral Settings esquema)
sectionGroup elemento para configSections (Geral Settings esquema)
<sectionGroup
name="section name"
type="configuration section handler class, assembly file name, version, culture, public key token"
<section />
/>
Atributos e elementos
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Atributos
Atributo |
Descrição |
---|---|
name |
Necessário String atributo. Especifica o nome do elemento que está associado com o manipulador de seção de configuração especificado pelo ou seção de configuraçãotype atributo. Este é o nome do group elemento sistema autônomo ele aparece na área de configurações de seção do arquivo de configuração. |
type |
Necessário String atributo. Especifica o nome da classe de manipulador de seção configuração que lida com o processamento das definições de configuração estão na seção ou elemento que está especificado no name atributo. Use o seguinte formato: type="Fully qualified class name, assembly file name, version, culture, public key token" A definição deve corresponde à referência do assembly. Por exemplo, se o número de versão no exemplo de código a seguir não coincidir com o assembly, ocorrerá um erro.
O arquivo do assembly deve ser localizado no mesmo diretório do aplicativo de Web. arquivo de configuração que define a ele. No caso do Web.config raiz ou computador arquivo de configuração, o arquivo do assembly deve estar no %SystemRoot%\Microsoft.NET\estrutura\ versão diretório. |
Elementos filho
Elemento |
Descrição |
---|---|
section |
Define uma associação entre um manipulador de seção de configuração e um elemento de configuração. |
sectionGroup |
Define uma associação entre um manipulador de seção de configuração e uma seção de configuração. |
Elementos pai
Elemento |
Descrição |
---|---|
configuration |
Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura. |
configSections |
Especifica o espaço para nome e a seção declarações de configuração. |
sectionGroup |
Define uma associação entre um manipulador de seção de configuração e uma seção de configuração. |
Comentários
The sectionGroup elemento atua sistema autônomo um contêiner para section elementos. A section elemento associa um manipulador de seção de configuração com um elemento de configuração ou seção. Isso é necessário porque o ASP.NET não facilita nenhum presumptions sobre como lidar com as configurações de dentro de um arquivo de configuração. Em vez disso, o ASP.NET delega o processamento de dados de configuração manipuladores de seção de configuração. Cada section elemento identifica uma seção de configuração ou elemento e a classe associada é derivada de ConfigurationSection classe que manipula o elemento ou seção de configuração. The section elementos podem ser agrupados logicamente em sectionGroup elementos para organizar o section elementos e para evitar conflitos de nomes. The section e sectionGroup elementos estão contidos na configSections elemento.
Configuração padrão
Seções de configuração para os elementos de configuração do .NET são definidas na computador. arquivo de configuração e são muito numerosas para serem listadas aqui. O seguinte trecho do arquivo computador.config define o manipulador de seção de configuração para o authentication elemento das system.web seção. Em seguida, as configurações são definidas para o authentication elemento.
Se um manipulador de seção de configuração não está associado a um elemento de configuração, ASP.NET emitirá o servidor de erro "a seção de configuração desconhecidoelement_name."
<configuration>
<configSections>
<sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
<section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
<!-- Other system.web sections -->
</sectionGroup>
<!-- Other configuration sections -->
</configSections>
<system.web>
<authentication mode="Windows">
<forms name=".ASPXAUTH"
loginUrl="login.aspx" defaultUrl="default.aspx"
protection="All"
timeout="30"
path="/"
requireSSL="False"
slidingExpiration="True"
cookieless="UseCookies"
domain=""
enableCrossAppRedirects="False">
<credentials passwordFormat="SHA1" />
</forms>
<passport redirectUrl="internal" />
</authentication>
<!-- Other system.web elements -->
</system.web>
<!-- Other configuration settings -->
</configuration>
Exemplo
O exemplo de código a seguir mostra como declarar um agrupar de seções e declarar seções dentro de um agrupar de seções.
<configuration>
<configSections>
<sectionGroup name="mySectionGroup">
<section name="mySection"
type="System.Configuration.NameValueSectionHandler" />
</sectionGroup>
</configSections>
<mySectionGroup>
<mySection>
<add key="key1" value="value1" />
</mySection>
</mySectionGroup>
</configuration>
Informações do elemento
Manipulador de seção de configuração |
Não se aplica. |
Configuração de membro |
|
Locais configuráveis |
Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config |
Requisitos |
Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 O .NET estrutura versão 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005 |
Consulte também
Conceitos
Hierarquia e Herança do Arquivo de Configuração do ASP.NET
Editando Arquivos de Configuração ASP.NET
Cenários de configuração ASP.NET
Referência
configSections elemento (Geral Settings esquema)
Elemento de seção para configSections (Geral Settings esquema)
desmarcar elemento configSections (Geral Settings esquema)
Remover elemento configSections (Geral Settings esquema)
configuração elemento (Geral Settings esquema)
Outros recursos
Configurações gerais (ASP.NET)
Definições de configuração ASP.NET
Arquivos de configuração ASP.NET