Compartilhar via


Adicionar elemento appSettings (Geral Configurações Schema)

Adiciona uma configuração de aplicativo personalizado como um par nome/valor à coleção de configurações do aplicativo.

<add
   key="String name"
   value="String value"
/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo

Descrição

key

Obrigatório String atributo.

Especifica o nome da configuração do aplicativo. Esse atributo é a chave da coleção.

value

Obrigatório String atributo.

Especifica o valor da configuração do aplicativo.

Atributos herdados

Atributos opcionais.

Atributos que são herdados por todos os elementos de seção. Para obter mais informações, consulte Geral Atributos Herdados por elementos de seção.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.

system.web

Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

appSettings

Contém configurações de aplicativo personalizado, como, por exemplo, caminhos de arquivo, URLs de serviço XML da Web ou qualquer informação que é armazenada no arquivo. ini para um aplicativo.

Comentários

O add elemento adiciona uma configuração de aplicativo personalizado como um par nome/valor à coleção de configurações de aplicativo herdado na appSettings elemento.

Observação importanteImportante

As chaves devem ser exclusivas.Se você adicionar várias entradas com a mesma chave somente a última entrada é mantida.

O appSettings elemento armazena informações de configuração de aplicativo personalizado, como caminhos de arquivo, URLs de serviço XML da Web ou qualquer informação que está armazenada no arquivo. ini para um aplicativo. Os pares chave/valor que são especificados no appSettings elemento pode ser acessado no código usando o ConfigurationSettings classe. O exemplo mostra como acessar o appSettings programaticamente.

Configuração padrão

O seguinte padrão appSettings elemento é configurado no arquivo Machine. config na.NET Framework versões 1.0 e 1.1.

<appSettings>
        <add key="XML File Name" value="myXmlFileName.xml" /> 
    </appSettings>

Exemplo

Os arquivos de configuração são especificados em um file atributo deve ter appSettings em vez de configuração como o nó raiz. O código a seguir está correto para um arquivo de configuração é especificado na 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

Membro de configuração

Add

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Virtual ou física directory–level Web. config

Requisitos

De da (IIS) versão 5.0, 5.1 ou 6.0

A.NET Framework versão 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Referência

appSettings Element (Geral Configurações Schema)

configuração Element (Geral Configurações Schema)

Desmarque elemento appSettings (Geral Configurações Schema)

remover o elemento appSettings (Geral Configurações Schema)

Conceitos

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Arquivos de configuração ASP.NET