Compartilhar via


appSettings Element (Geral Configurações Schema)

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 de the.ini para um aplicativo.

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

Atributos e elementos

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

Atributos

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 especificados no appSettings Adicionar, 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 runtime ignora o atributo, se o arquivo especificado não foi encontrado.

Como 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 o aplicativo para reiniciar. O conteúdo do arquivo separado é mesclado com o appSettings seção no arquivo Web. config. Essa funcionalidade é limitada para o appSettings atributo.

Notana.NET Framework versão 2.0, agora você pode incluir as configurações 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, 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 de aplicativos. Para obter mais informações, consulte ConfigSource.

Atributos herdados

Atributos opcionais.

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

Elementos filho

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 herdadas do aplicativo personalizado e permite que somente as referências são adicionadas pelo atual Adicionar atributo.

remove

Elemento opcional.

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

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.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 para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Comentários

O appSettings elemento armazena informações de configuração de aplicativo personalizado, como caminhos de arquivo, URLs de serviço XML da Web ou qualquer informação que está armazenada no arquivo de 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 saber 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 quando um usuário desejar substituir as configurações de projeto que são especificadas em um arquivo de configuração do aplicativo. Os arquivos de configuração 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 elemento (ASP.NET Configurações Schema) coleção em vez de coleção de configurações de aplicativo.

Configuração padrão

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

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

Exemplo

Os arquivos de configuração 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 é especificado 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>

Informações do elemento

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

Virtual ou física directory–level Web. config

Requisitos

De 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

Referência

configuração Element (Geral Configurações Schema)

Adicionar elemento appSettings (Geral Configurações Schema)

Desmarque elemento appSettings (Geral Configurações Schema)

remover o elemento appSettings (Geral Configurações Schema)

Conceitos

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Arquivos de configuração ASP.NET