<elemento appSettings> para <configuração>
Contém definições de aplicação personalizadas. Esta é uma secção de configuração predefinida fornecida pelo .NET Framework.
<configuração>
<appSettings>
Syntax
<appSettings>
<!-- Elements to add, clear, or remove configuration settings -->
</appSettings>
Atributo
| Descrição | |
|---|---|
| ficheiro | Atributo opcional. Especifica um caminho relativo para um ficheiro externo que contém definições de configuração de aplicações personalizadas. O ficheiro especificado contém o mesmo tipo de definições especificadas nos <elementos adicionar>, <remover> e <limpar> e utiliza o mesmo formato de par chave/valor que esses elementos. O caminho especificado é relativo ao ficheiro de configuração principal. Para uma aplicação Windows Forms, esta é a pasta binária (como /bin/debug) e não a localização do ficheiro de configuração da aplicação. Para Web Forms aplicações, o caminho é relativo à raiz da aplicação, onde se encontra o ficheiro deweb.config. O runtime ignora o atributo se não for possível encontrar o ficheiro especificado. |
Elemento principal
| Description | |
|---|---|
| <elemento de configuração> | O elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de idioma comum e .NET Framework aplicações. |
Elementos subordinados
| Description | |
|---|---|
| <adicionar> | Adiciona uma definição de aplicação personalizada. |
| <limpar> | Limpa todas as definições de aplicação definidas anteriormente. |
| <remover> | Remove uma definição de aplicação definida anteriormente. |
Observações
O <elemento appSettings> armazena informações de configuração de aplicações personalizadas, tais como cadeias de ligação de base de dados, caminhos de ficheiros, URLs do serviço Web XML ou quaisquer outras informações de configuração personalizadas para uma aplicação. Os pares chave/valor especificados no <elemento appSettings são acedidos> em código com a ConfigurationSettings classe.
Pode utilizar o atributo de ficheiro no <elemento appSettings dos ficheiros> de configuração daWeb.config e da aplicação. Este atributo especifica um ficheiro de configuração que fornece definições adicionais ou substitui as definições especificadas no <elemento appSettings> . O atributo de ficheiro pode ser utilizado em cenários de desenvolvimento da equipa de controlo de origem, como quando um utilizador quer substituir as definições de projeto especificadas num ficheiro de configuração da aplicação.
Os ficheiros de configuração especificados pelo atributo de ficheiro têm de ter um nó raiz de <appSettings> em vez de <configuração>.
Exemplo
O exemplo seguinte mostra um ficheiro de definições de aplicação externa (custom.config) que define uma definição de aplicação personalizada:
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>
O exemplo seguinte mostra um ficheiro de configuração de aplicação que consome a definição no ficheiro de definições externas e define uma definição de aplicação própria:
<configuration>
<appSettings file="custom.config">
<add key="ApplicationName" value="MyApplication" />
</appSettings>
</configuration>
Ficheiro de configuração
Este elemento pode ser utilizado no ficheiro de configuração da aplicação, no ficheiro de configuração do computador (Machine.config) e Web.config ficheiros que não estão ao nível do diretório da aplicação.
