Compartilhar via

<appSettings> elemento para <configuração>

Contém configurações de aplicativo personalizadas. Esta é uma seção de configuração predefinida fornecida pelo .NET Framework.

<configuração>
   <Appsettings>

Sintaxe

<appSettings>
  <!-- Elements to add, clear, or remove configuration settings -->
</appSettings>

Attribute

Description
file Atributo opcional.

Especifica um caminho relativo para um arquivo externo que contém configurações de configuração de aplicativo personalizadas. O arquivo especificado contém o mesmo tipo de configurações especificadas no <add>, <remove>e elementos e <clear> usa o mesmo formato de par chave/valor que esses elementos.

O caminho especificado é relativo ao arquivo de configuração principal. Para um aplicativo do Windows Forms, essa é a pasta binária (como /bin/debug), não o local do arquivo de configuração do aplicativo. Para aplicativos web forms, o caminho é relativo à raiz do aplicativo, em que o arquivo web.config está localizado.

O runtime ignorará o atributo se o arquivo especificado não puder ser encontrado.

Elemento pai

Description
<configuration> Elemento O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.

Elementos filho

Description
<adicionar> Adiciona uma configuração de aplicativo personalizada.
<claro> Limpa todas as configurações de aplicativo definidas anteriormente.
<retirar> Remove uma configuração de aplicativo definida anteriormente.

Observações

O <appSettings> elemento armazena informações personalizadas de configuração de aplicativo, como cadeias de conexão de banco de dados, caminhos de arquivo, URLs de serviço Web XML ou qualquer outra informação de configuração personalizada para um aplicativo. Os pares chave/valor especificados no <appSettings> elemento são acessados no código usando a ConfigurationSettings classe.

Você pode usar o file atributo no <appSettings> elemento dos arquivos de configuração doWeb.config e do aplicativo. Esse atributo especifica um arquivo de configuração que fornece configurações adicionais ou substitui as configurações especificadas no <appSettings> elemento. O file atributo pode ser usado em cenários de desenvolvimento da equipe de controle do código-fonte, como quando um usuário deseja substituir as configurações de projeto especificadas em um arquivo de configuração do aplicativo.

Os arquivos de configuração especificados pelo file atributo devem ter um nó raiz em vez <appSettings>de <configuration> .

Example

O exemplo a seguir mostra um arquivo de configurações de aplicativo externo (custom.config) que define uma configuração de aplicativo personalizada:

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
  <add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>

O exemplo a seguir mostra um arquivo de configuração de aplicativo que consome a configuração no arquivo de configurações externas e define uma configuração de aplicativo própria:

<configuration>
  <appSettings file="custom.config">
    <add key="ApplicationName" value="MyApplication" />
  </appSettings>
</configuration>

Arquivo de configuração

Esse elemento pode ser usado no arquivo de configuração do aplicativo, no arquivo de configuração do computador (Machine.config) e Web.config arquivos que não estão no nível do diretório do aplicativo.

Consulte também

  • Last updated on