Elemento add per appSettings (schema delle impostazioni generali)
Aggiornamento: novembre 2007
Aggiunge un'impostazione personalizzata dell'applicazione come coppia di nome/valore all'insieme delle impostazioni dell'applicazione.
Elemento configuration (schema delle impostazioni generali)
Elemento appSettings (schema delle impostazioni generali)
Elemento add per appSettings (schema delle impostazioni generali)
<add
key="String name"
value="String value"
/>
Attributi ed elementi
Le seguenti sezioni illustrano attributi, elementi figlio e padre.
Attributi
Attributo |
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. |
Elementi figlio
Nessuno.
Elementi padre
Elemento |
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.
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.
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 principale 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 |
|
Membro di configurazione |
|
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
Concetti
Protezione della configurazione di ASP.NET
Scenari di configurazione ASP.NET
Riferimenti
Elemento appSettings (schema delle impostazioni generali)
Elemento configuration (schema delle impostazioni generali)
Elemento clear per appSettings (schema delle impostazioni generali)
Elemento remove per appSettings (schema delle impostazioni generali)
Altre risorse
Impostazioni di configurazione generali (ASP.NET)