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 |
|
Membro de configuração |
|
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)