Adicionar elemento appSettings (Geral Settings esquema)

Artigo
08/25/2010

Adiciona uma configuração de aplicativo personalizado sistema autônomo um emparelhar nome/valor à coleção de configurações de aplicativo.

configuração elemento (Geral Settings esquema)
appSettings elemento (Geral Settings esquema)
Adicionar elemento appSettings (Geral Settings esquema)

<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	Necessário String atributo. Especifica o nome da configuração de aplicativo. Esse atributo é a chave da coleção.
value	Necessário String atributo. Especifica o valor da configuração de aplicativo.
Atributos herdados	Atributos opcionais. Atributos que são herdados por todos os elementos de seção. Para obter mais informações, consulte Atributos Geral herdados por elementos de seção.

key

Necessário String atributo.

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

value

Necessário String atributo.

Especifica o valor da configuração de aplicativo.

Atributos herdados

Atributos opcionais.

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

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
configuration	Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.
system.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.
appSettings	Contém configurações de aplicativo personalizado, sistema autônomo caminhos de arquivo, serviço Web XML URLs ou qualquer informação armazenada no arquivo .ini para um aplicativo.

Comentários

The add elemento adiciona uma configuração de aplicativo personalizado sistema autônomo um emparelhar nome/valor à coleção de configurações de aplicativo herdado na appSettings elemento.

The appSettings elemento armazena informações de configuração de aplicativo personalizado, sistema autônomo caminhos de arquivo, URLs de serviço XML da Web ou qualquer informação que é armazenada no arquivo .ini para um aplicativo. Os pares de chave/valor são especificados no appSettings elemento pode ser acessado no código usando o ConfigurationSettings classe.

Configuração padrão

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

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

Exemplo

Arquivos de configuração que são especificados em um file atributo deve ter appSettings em vez de configuração sistema autônomo o nó raiz. O código a seguir está correto para um arquivo de configuração que é especificado no 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 da seção de configuração	AppSettingsSection
Configuração de membro	Add
Locais configuráveis	Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 O .NET estrutura versão 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Compartilhar via