Partilhar via

<appSettings> elemento para <configuração>

Contém definições de aplicação personalizadas. Esta é uma secção de configuração pré-definida 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 ficheiro externo contendo definições de configuração de aplicações personalizadas. O ficheiro especificado contém o mesmo tipo de definições que são especificadas nos <add>elementos , <remove>, e <clear> utiliza o mesmo formato de par chave/valor desses elementos.

O caminho especificado é relativo ao ficheiro principal de configuração. Para uma aplicação Windows Forms, esta é a pasta binária (como /bin/debug), não a localização do ficheiro de configuração da aplicação. Para aplicações Web Forms, o caminho é relativo à raiz da aplicação, onde se encontra o ficheiroweb.config .

O runtime ignora o atributo se o ficheiro especificado não for encontrado.

Elemento pai

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

Elementos filho

Description
<acrescentar> Adiciona uma configuração de aplicação personalizada.
<Claro> Apaga todas as definições de aplicação previamente definidas.
<remover> Remove uma configuração de aplicação previamente definida.

Observações

O <appSettings> elemento armazena informações de configuração personalizadas da aplicação, como cadeias de ligação à base de dados, caminhos de ficheiros, URLs de serviços Web XML ou qualquer outra informação de configuração personalizada para uma aplicação. Os pares chave/valor especificados no <appSettings> elemento são acedidos em código usando a ConfigurationSettings classe.

Podes usar o file atributo no <appSettings> elemento 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 sobrepõe as definições especificadas no <appSettings> elemento. O file atributo pode ser usado em cenários de desenvolvimento de equipas de controlo de versão, como quando um utilizador quer sobrepor as definições do projeto especificadas num ficheiro de configuração de aplicação.

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

Example

O exemplo seguinte mostra um ficheiro externo de definições de aplicação (custom.config) que define uma configuraçã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 configuração de aplicação própria:

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

Arquivo de configuração

Este elemento pode ser usado no ficheiro de configuração da aplicação, ficheiro de configuração da máquina (Machine.config) e Web.config ficheiros que não estejam ao nível do diretório da aplicação.

Consulte também

  • Last updated on