appSettings elemento (Geral Settings esquema)

Artigo
08/25/2010

Contém configurações de aplicativo personalizado, sistema autônomo caminhos de arquivo, serviço Web XML URLs ou qualquer informação armazenada no arquivo the.ini para um aplicativo.

configuração elemento (Geral Settings esquema)
appSettings elemento (Geral Settings esquema)

<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. The specified file contains the same kind of settings that are specified in the appSettings add, clear, and remove attributes and uses the same key/value pair format as those elements. O caminho especificado é relativo ao arquivo de configuração local. O tempo de execução ignora o atributo, se o arquivo especificado não puder ser encontrado. Porque qualquer altera para o arquivo Web.config fazer com que o aplicativo reiniciar, usando um separado arquivo permite aos usuários modificar os valores que estão no appSettings seção sem fazendo com que o aplicativo seja reiniciado. O Sumário de arquivo separado é mesclado com o appSettings seção na Web. arquivo de configuração. Essa funcionalidade é limitada ao appSettings atributo. Observação: No .NET estrutura versão 2.0, agora você pode incluir as configurações de um arquivo separado para todos os elementos de configuração que oferecem suporte a configSource atributo. No entanto, quando você usar o configSource atributo, você deve mover toda a seção para o arquivo separado porque não há nenhum mesclagem das configurações do elemento. Há uma única gravar para o arquivo Web.config quando usando o configSource atributo. Isso faz com que o aplicativo seja reiniciado, mas atualizações subseqüentes para a 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. The specified file contains the same kind of settings that are specified in the appSettings add, clear, and remove attributes and uses the same key/value pair format as those elements.

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

Porque qualquer altera para o arquivo Web.config fazer com que o aplicativo reiniciar, usando um separado arquivo permite aos usuários modificar os valores que estão no appSettings seção sem fazendo com que o aplicativo seja reiniciado. O Sumário de arquivo separado é mesclado com o appSettings seção na Web. arquivo de configuração. Essa funcionalidade é limitada ao appSettings atributo.

Observação: No .NET estrutura versão 2.0, agora você pode incluir as configurações de um arquivo separado para todos os elementos de configuração que oferecem suporte a configSource atributo. No entanto, quando você usar o configSource atributo, você deve mover toda a seção para o arquivo separado porque não há nenhum mesclagem das configurações do elemento. Há uma única gravar para o arquivo Web.config quando usando o configSource atributo. Isso faz com que o aplicativo seja reiniciado, mas atualizações subseqüentes para a 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.

Elementos filho

Elemento	Descrição
add	Elemento opcional. Adiciona uma configuração de aplicativo personalizado sistema autônomo um emparelhar nome/valor à coleção de configurações de aplicativo.
clear	Elemento opcional. Remove todas as referências para configurações de aplicativo personalizados herdados e permite que as referências são adicionadas pelo corrente Adicionar atributo.
remove	Elemento opcional. Remove uma referência a uma configuração de aplicativo personalizados herdados da coleção de configurações de aplicativo.

add

Elemento opcional.

Adiciona uma configuração de aplicativo personalizado sistema autônomo um emparelhar nome/valor à coleção de configurações de aplicativo.

clear

Elemento opcional.

Remove todas as referências para configurações de aplicativo personalizados herdados e permite que as referências são adicionadas pelo corrente Adicionar atributo.

remove

Elemento opcional.

Remove uma referência a uma configuração de aplicativo personalizados herdados da coleção de configurações de aplicativo.

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.
system.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

Comentários

The appSettings elemento armazena informações de configuração de aplicativo personalizado, sistema autônomo 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 de chave/valor são especificados no appSettings elemento pode ser acessado no código usando o ConfigurationSettings classe.

Você pode usar o file atributo para especificar uma configuração de arquivo que fornece configurações adicionais ou substitui as configurações especificadas no appSettings elemento. Você pode usar o file atributo na fonte de controle equipe desenvolvimento cenários, tais sistema autônomo quando um usuário desejar substituir sistema autônomo configurações de projeto especificados 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 sistema autônomo o nó raiz.

Em aplicativos .NET estrutura versão 2.0, armazenar seqüências de caracteres de conexão de banco de dados no connectionStrings elemento (ASP.NET Settings esquema) coleção em vez de coleção de configurações de aplicativo.

Configuração padrão

O seguinte padrão appSettings elemento não está configurado explicitamente na computador. arquivo de configuração ou na Web raiz. arquivo de configuração. No entanto, é 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 da configuração elemento sistema autônomo o nó raiz.

O exemplo de código a seguir demonstra como usar o formato correto para um arquivo de configuração que é especificado no 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 de seção de configuração	AppSettingsSection
Configuração de membro	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ísico diretório–nível Web.config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) 5.0, 5.1 ou 6.0 O .NET estrutura versão 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Partilhar via

appSettings elemento (Geral Settings esquema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Conceitos

Referência

Outros recursos

Recursos adicionais