Adicionar elemento appSettings (General Settings Schema)
[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]
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"
/>
Attributes and Elements
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Attributes
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 Atributos gerais, herdada por elementos de seção. |
Child Elements
Nenhum.
Parent Elements
Elemento |
Descrição |
|---|---|
configuration |
Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.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 que 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. |
Remarks
O add elemento adiciona uma configuração de aplicativo personalizado como um par nome/valor à coleção de configurações do aplicativo herdado no appSettings elemento.
Importante
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 da Web em XML ou quaisquer informações armazenadas 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
Arquivos de configuração que 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 especificada 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>
Element Information
Manipulador de seção de configuração |
|
Membro de configuração |
|
Locais configuráveis |
Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Directory–level virtuais ou físicas Web. config |
Requisitos |
Serviços de Informações da Internet da Microsoft (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
Reference
appSettings Element (General Settings Schema)
configuração Element (General Settings Schema)
Desmarque elemento appSettings (General Settings Schema)
remover o elemento appSettings (General Settings Schema)
Concepts
Other Resources
Configurações gerais (ASP.NET)