Schema Application Settings

Articolo
09/12/2008

Aggiornamento: novembre 2007

Questo schema consente a un'applicazione Windows Form o ASP.NET di memorizzare e recuperare le impostazioni con ambito di applicazione o di utente. In questo contesto, per impostazione si intende un qualsiasi elemento di informazione che può essere specifico per l'applicazione o per l'utente corrente, ad esempio un qualsiasi elemento di una stringa di connessione al database relativo alla dimensione preferita della finestra predefinita dell'utente.

Per impostazione predefinita, Application Settings in un'applicazione Windows Form utilizza la classe LocalFileSettingsProvider, che utilizza il sistema di configurazione .NET per memorizzare le impostazioni in un file di configurazione XML. Per ulteriori informazioni sui file utilizzati da Application Settings, vedere Architettura Impostazioni applicazione.

Application Settings definisce i seguenti elementi all'interno dei file di configurazione utilizzati.

Elemento	Descrizione
Elemento <applicationSettings>	Contiene tutti i tag <setting> specifici per l'applicazione.
Elemento <userSettings>	Contiene tutti i tag <setting> specifici per l'utente corrente.
Elemento <setting>	Definisce un'impostazione. Figlio di <applicationSettings> o <userSettings>.
Elemento <value>	Definisce il valore di un'impostazione. Figlio di <setting>.

Elemento <applicationSettings>

Questo elemento contiene tutti i tag <setting> specifici per un'istanza dell'applicazione su un computer client. Non definisce alcun attributo.

Elemento <userSettings>

Questo elemento contiene tutti i tag <setting> specifici per l'utente che sta attualmente utilizzando l'applicazione. Non definisce alcun attributo.

Elemento <setting>

Questo elemento definisce un'impostazione e dispone degli attributi riportati di seguito.

Elemento	Descrizione
name	Obbligatorio. ID univoco dell'impostazione. Le impostazioni create mediante Visual Studio vengono salvate con il nome ProjectName.Properties.Settings.
serializedAs	Obbligatorio. Formato da utilizzare per la serializzazione del valore in testo. I valori validi sono: string: il valore viene serializzato come stringa mediante TypeConverter. xml: il valore viene serializzato mediante la serializzazione XML. binary: il valore viene serializzato come valore binario con testo codificato mediante la serializzazione binaria. custom: il fornitore possiede una conoscenza intrinseca di questa impostazione e quindi eseguirà la relativa serializzazione e deserializzazione. Per utilizzare la serializzazione binaria o personalizzata, è necessario definire una propria classe settings e utilizzare SettingsSerializeAsAttribute per specificare la serializzazione binaria o personalizzata.

name

Obbligatorio. ID univoco dell'impostazione. Le impostazioni create mediante Visual Studio vengono salvate con il nome ProjectName.Properties.Settings.

serializedAs

Obbligatorio. Formato da utilizzare per la serializzazione del valore in testo. I valori validi sono:

string: il valore viene serializzato come stringa mediante TypeConverter.
xml: il valore viene serializzato mediante la serializzazione XML.
binary: il valore viene serializzato come valore binario con testo codificato mediante la serializzazione binaria.
custom: il fornitore possiede una conoscenza intrinseca di questa impostazione e quindi eseguirà la relativa serializzazione e deserializzazione.
Per utilizzare la serializzazione binaria o personalizzata, è necessario definire una propria classe settings e utilizzare SettingsSerializeAsAttribute per specificare la serializzazione binaria o personalizzata.

Elemento <value>

Questo elemento contiene il valore di un'impostazione.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato un file Application Settings che definisce due impostazioni con ambito di applicazione e due impostazioni con ambito di utente.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <configSections>
        <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
        </sectionGroup>
        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />
        </sectionGroup>
    </configSections>
    <applicationSettings>
        <WindowsApplication1.Properties.Settings>
            <setting name="Cursor" serializeAs="String">
                <value>Default</value>
            </setting>
            <setting name="DoubleBuffering" serializeAs="String">
                <value>False</value>
            </setting>
        </WindowsApplication1.Properties.Settings>
    </applicationSettings>
    <userSettings>
        <WindowsApplication1.Properties.Settings>
            <setting name="FormTitle" serializeAs="String">
                <value>Form1</value>
            </setting>
            <setting name="FormSize" serializeAs="String">
                <value>595, 536</value>
            </setting>
        </WindowsApplication1.Properties.Settings>
    </userSettings>
</configuration>

Vedere anche

Concetti

Cenni preliminari sulle impostazioni delle applicazioni

Architettura Impostazioni applicazione

Condividi tramite