appSettings Element (General Settings Schema)

Artigo
05/28/2012

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Contém configurações de aplicativo personalizado, como, por exemplo, caminhos de arquivo, URLs de serviço XML da Web ou qualquer informação que é armazenada no arquivo the.ini para um aplicativo.

<appSettings
   file="relative file name" >
</appSettings>

Attributes and Elements

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Attributes

Elemento	Descrição
file	Opcional String atributo. Especifica um caminho relativo para um arquivo externo que contém definições de configuração de aplicativo personalizado. O arquivo especificado contém o mesmo tipo de configurações que são especificadas na appSettingsAdicionar, Limpar, e Remover atributos e usa o mesmo formato do par chave/valor como esses elementos. O caminho especificado é relativa ao arquivo de configuração local. O tempo de execução ignora o atributo, se o arquivo especificado não foi encontrado. Como todas as alterações no arquivo Web. config causarem para reinicialização do aplicativo, usar um arquivo separado permite que os usuários modificar os valores que estão na appSettings seção sem causar para reinicialização do aplicativo. O conteúdo do arquivo separado é mesclado com a appSettings seção no arquivo Web. config. Essa funcionalidade é limitada para o appSettings atributo. Nota na.NET Framework versão 2.0, agora é possível incluir definições de configuração em um arquivo separado para todos os elementos de configuração que oferecem suporte a configSource atributo. No entanto, quando você usa o configSource atributo, você deverá mover a seção inteira para o arquivo separado porque não há nenhum mesclagem das configurações do elemento. Há uma única gravação no arquivo Web. config quando usando o configSource atributo. Isso faz com que o aplicativo reiniciar, mas as atualizações subseqüentes à seção são gravadas diretamente no arquivo separado e não causam reinicializações subseqüentes do aplicativo. Para obter mais informações, consulte ConfigSource.
Atributos herdados	Atributos opcionais. Atributos herdados por todos os elementos de seção.

file

Opcional String atributo.

Especifica um caminho relativo para um arquivo externo que contém definições de configuração de aplicativo personalizado. O arquivo especificado contém o mesmo tipo de configurações que são especificadas na appSettingsAdicionar, Limpar, e Remover atributos e usa o mesmo formato do par chave/valor como esses elementos.

O caminho especificado é relativa ao arquivo de configuração local. O tempo de execução ignora o atributo, se o arquivo especificado não foi encontrado.

Como todas as alterações no arquivo Web. config causarem para reinicialização do aplicativo, usar um arquivo separado permite que os usuários modificar os valores que estão na appSettings seção sem causar para reinicialização do aplicativo. O conteúdo do arquivo separado é mesclado com a appSettings seção no arquivo Web. config. Essa funcionalidade é limitada para o appSettings atributo.

Nota na.NET Framework versão 2.0, agora é possível incluir definições de configuração em um arquivo separado para todos os elementos de configuração que oferecem suporte a configSource atributo. No entanto, quando você usa o configSource atributo, você deverá mover a seção inteira para o arquivo separado porque não há nenhum mesclagem das configurações do elemento. Há uma única gravação no arquivo Web. config quando usando o configSource atributo. Isso faz com que o aplicativo reiniciar, mas as atualizações subseqüentes à seção são gravadas diretamente no arquivo separado e não causam reinicializações subseqüentes do aplicativo. Para obter mais informações, consulte ConfigSource.

Atributos herdados

Atributos opcionais.

Atributos herdados por todos os elementos de seção.

Child Elements

Elemento	Descrição
add	Elemento opcional. Adiciona uma configuração de aplicativo personalizado como um par nome/valor à coleção de configurações do aplicativo.
clear	Elemento opcional. Remove todas as referências para configurações de aplicativo personalizado herdadas e permite que somente as referências que são adicionadas pelo atual Adicionar atributo.
remove	Elemento opcional. Remove uma referência a uma configuração de aplicativo personalizado herdadas de coleção de configurações do aplicativo.

add

Elemento opcional.

Adiciona uma configuração de aplicativo personalizado como um par nome/valor à coleção de configurações do aplicativo.

clear

Elemento opcional.

Remove todas as referências para configurações de aplicativo personalizado herdadas e permite que somente as referências que são adicionadas pelo atual Adicionar atributo.

remove

Elemento opcional.

Remove uma referência a uma configuração de aplicativo personalizado herdadas de coleção de configurações do aplicativo.

Parent Elements

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.Aplicativos do NET Framework.
system.web	Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Remarks

O appSettings elemento armazena informações de configuração de aplicativo personalizado, como, por exemplo, caminhos de arquivo, URLs de serviço XML da Web ou qualquer informação que é armazenada no arquivo the.ini para um aplicativo. Os pares chave/valor que são especificados no appSettings elemento pode ser acessado no código usando o ConfigurationManager classe. Consulte o exemplo de código mostrado na classe para ver como acessar o appSettings programaticamente.

Você pode usar o file atributo para especificar uma configuração de arquivo que fornece configurações adicionais ou substitui as configurações especificadas na appSettings elemento. Você pode usar o file atributo em cenários de desenvolvimento do código-fonte controle team, como, por exemplo, quando um usuário desejar substituir as configurações de projeto que são especificadas em um arquivo de configuração do aplicativo. Arquivos de configuração que são especificados em um file atributo deve ter o appSettings elemento em vez de configuração elemento como o nó raiz.

No.Aplicativos do NET Framework versão 2.0, armazene seqüências de conexão de banco de dados na connectionStrings Element (ASP.NET Settings Schema) coleção em vez de uma coleção de configurações do aplicativo.

Configuração padrão

O seguinte padrão appSettings elemento não está explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, ele é a configuração padrão que é retornada pelo aplicativo.

   <appSettings file="">
      <settings>
         <clear />
      </settings>
   </appSettings>

Exemplo

Arquivos de configuração que são especificados em um file atributo deve ter o appSettings elemento em vez de configuração elemento como o nó raiz.

O exemplo de código a seguir demonstra como usar o formato correto para um arquivo de configuração especificada na file atributo.

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>

O exemplo de código a seguir mostra como definir uma configuração de aplicativo personalizado em um arquivo de configuração.

<configuration>
    <appSettings>
        <add key="Application Name" value="MyApplication" />
    </appSettings>
</configuration>

Element Information

Manipulador da seção de configuração	AppSettingsSection
Membro de configuração	AppSettings AppSettings AppSettings
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Directory–level virtuais ou físicas Web. config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) 5.0, 5.1 ou 6.0 A.NET Framework versão 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Compartilhar via

appSettings Element (General Settings Schema)

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Configuração padrão

Exemplo

Element Information

Consulte também

Reference

Concepts

Other Resources

Recursos adicionais