Elemento add per appSettings (schema delle impostazioni generali)

Articolo
08/11/2011

Aggiunge un'impostazione personalizzata dell'applicazione come coppia di nome/valore all'insieme delle impostazioni dell'applicazione.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	Descrizione
key	Attributo String obbligatorio. Specifica il nome dell'impostazione dell'applicazione. Questo attributo è la chiave dell'insieme.
value	Attributo String obbligatorio. Specifica il valore dell'impostazione dell'applicazione.
Attributi ereditati	Attributi facoltativi. Attributi ereditati da tutti gli elementi della sezione. Per ulteriori informazioni, vedere Attributi generali ereditati da elementi di sezioni.

key

Attributo String obbligatorio.

Specifica il nome dell'impostazione dell'applicazione. Questo attributo è la chiave dell'insieme.

value

Attributo String obbligatorio.

Specifica il valore dell'impostazione dell'applicazione.

Attributi ereditati

Attributi facoltativi.

Attributi ereditati da tutti gli elementi della sezione. Per ulteriori informazioni, vedere Attributi generali ereditati da elementi di sezioni.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
configuration	Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.web	Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento.
appSettings	Contiene le impostazioni personalizzate dell'applicazione, quali percorsi di file, URL di servizi Web XML o qualsiasi informazione archiviata nel file ini di un'applicazione.

Note

L'elemento add aggiunge un'impostazione personalizzata dell'applicazione come coppia di nome/valore all'insieme delle impostazioni dell'applicazione ereditate nell'elemento appSettings.

Importante
Le chiavi devono essere univoche.Se si aggiungono più voci con la stessa chiave, solo l'ultima voce viene mantenuta.

L'elemento appSettings contiene le informazioni sulla configurazione dell'applicazione personalizzata, quali percorsi di file, URL di servizi Web XML o qualsiasi informazione archiviata nel file ini di un'applicazione. È possibile accedere nel codice alle coppie chiave/valore specificate nell'elemento appSettings utilizzando la classe ConfigurationSettings. Nell'esempio della classe viene illustrato come accedere alla sezione appSettings a livello di codice.

Configurazione predefinita

Nel file Machine.config in .NET Framework versioni 1.0 e 1.1 viene configurato l'elemento appSettings predefinito riportato di seguito.

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

Esempio

Nei file di configurazione specificati in un attributo file il nodo radice deve essere appSettings anziché configuration. Il seguente codice è corretto per un file di configurazione specificato nell'attributo file.

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>

Nell'esempio di codice riportato di seguito viene illustrato come definire un'impostazione personalizzata dell'applicazione in un file di configurazione.

<configuration>
    <appSettings>
        <add key="Application Name" value="MyApplication" />
    </appSettings>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	AppSettingsSection
Membro di configurazione	Add
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 1.0, 1.1 o 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite