<elemento appSettings> para <configuração>
Contém configurações de aplicativo personalizadas. Esta é uma seção de configuração predefinida fornecida pelo .NET Framework.
<configuration>
<appSettings>
Syntax
<appSettings>
<!-- Elements to add, clear, or remove configuration settings -->
</appSettings>
Atributo
| Descrição | |
|---|---|
| file | Atributo opcional. Especifica um caminho relativo para um arquivo externo que contém configurações de aplicativo personalizadas. O arquivo especificado contém o mesmo tipo de configurações especificadas nos <elementos add>, <remove> e <clear> e usa o mesmo formato de par chave/valor que esses elementos. O caminho especificado é relativo ao arquivo de configuração principal. Para um aplicativo 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 ignora o atributo se o arquivo especificado não puder ser encontrado. |
Elemento pai
| Descrição | |
|---|---|
| <Elemento> de configuração | O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework. |
Elementos filho
| Descrição | |
|---|---|
| <add> | Adiciona a configuração personalizada do aplicativo. |
| <clear> | Limpa todas as configurações de aplicativo definidas anteriormente. |
| <remove> | Remove uma configuração de aplicativo definida anteriormente. |
Comentários
O <elemento appSettings> armazena informações de configuração de aplicativo personalizado, 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 <elemento appSettings são acessados> no código usando a ConfigurationSettings classe.
Você pode usar o atributo de arquivo no <elemento appSettings> dos arquivos de configuração doWeb.config e do aplicativo. Este atributo especifica um arquivo de configuração que fornece configurações adicionais ou substitui as configurações especificadas no elemento <appSettings>. O atributo de arquivo 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 de aplicativo.
Os arquivos de configuração especificados pelo atributo de arquivo devem ter um nó raiz de appSettings< em vez de><configuração>.
Exemplo
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 sua própria configuração de aplicativo:
<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 de aplicativo, no arquivo de configuração do computador (Machine.config) e em arquivos Web.config que não estão no nível do diretório do aplicativo.
