Impostazioni di applicazioni

Le impostazioni dell'applicazione consentono di archiviare e recuperare in modo dinamico le impostazioni delle proprietà e altre informazioni relative all'applicazione. Consentono anche di gestire le preferenze personalizzate a livello di applicazione e utente nel computer client. Spesso si tratta di dati critici per l'esecuzione dell'applicazione, ad esempio una stringa di connessione, che è preferibile non includere direttamente nel codice dell'applicazione. Può essere opportuno archiviare due diversi stringhe di connessione del database e recuperare una di esse in fase di esecuzione in base al percorso del computer. In alternativa, può essere opportuno archiviare le preferenze di un utente relative ai colori e recuperarle alla successiva esecuzione dell'applicazione.

Le impostazioni dell'applicazione sono una funzionalità di Visual Studio che sostituisce la funzionalità delle proprietà dinamiche delle versioni precedenti. Per informazioni sulle proprietà dinamiche, vedere Configurazione di applicazioni mediante proprietà dinamiche.

Ogni impostazione dell'applicazione deve avere un nome univoco. Tale nome può essere formato da una combinazione di lettere, numeri o un carattere di sottolineatura, non può iniziare con un numero e non può contenere spazi. Il nome può essere modificato tramite la proprietà Name.

Le impostazioni dell'applicazione possono essere archiviate come qualsiasi tipo di dati XML serializzabile oppure contenente un oggetto TypeConverter che implementa ToString/FromString. I tipi più comuni sono String, Integer e Boolean, ma è anche possibile archiviare i valori come Color, Object o come una stringa di connessione.

Anche le impostazioni dell'applicazione contengono un valore. Il valore viene impostato con la proprietà Valore e deve corrispondere al tipo di dati dell'impostazione.

Inoltre, in fase di progettazione, è possibile associare le impostazioni dell'applicazione alla proprietà di un form o di un controllo. Per ulteriori informazioni, vedere Procedura: aggiungere o rimuovere impostazioni dell'applicazione.

Sono disponibili due tipi di impostazioni dell'applicazione, in base all'ambito:

• Le impostazioni con ambito di applicazione possono essere utilizzate per informazioni quali un URL per un servizio Web o una stringa di connessione del database. Questi valori sono associati all'applicazione. Di conseguenza, gli utenti non possono modificarli in fase di esecuzione.

• Le impostazioni con ambito di utente possono essere utilizzate per informazioni quali la memorizzazione dell'ultima posizione di un form oppure una preferenza su un tipo di carattere. Gli utenti possono modificare questi valori in fase di esecuzione.

È possibile modificare il tipo di un'impostazione utilizzando la proprietà Ambito.

Nel sistema del progetto le impostazioni dell'applicazione vengono archiviate in due file XML: un file app.config, creato in fase di progettazione al momento della creazione della prima impostazione dell'applicazione, e un file user.config, creato in fase di esecuzione quando l'utente che esegue l'applicazione modifica il valore di una qualsiasi impostazione utente. Le modifiche apportate alle impostazioni utente non vengono scritte su disco a meno che nell'applicazione non venga specificamente chiamato un metodo che esegua questa operazione.

Creazione di impostazioni dell'applicazione in fase di progettazione

In fase di progettazione, le impostazioni dell'applicazione possono essere create in due modi, mediante la pagina Impostazioni di Progettazione progetti oppure mediante la finestra Proprietà per un form o un controllo, che consente di associare un'impostazione direttamente a una proprietà. Per ulteriori informazioni, vedere Procedura: aggiungere o rimuovere impostazioni dell'applicazione.

Quando si crea un'impostazione con ambito di applicazione, ad esempio una stringa di connessione del database oppure un riferimento a risorse del server, in Visual Studio tale impostazione viene salvata nel file app.config con il tag <applicationSettings>. (Le stringhe di connessione vengono salvate nel tag <connectionStrings>.)

Quando si crea un'impostazione con ambito di utente, ad esempio il tipo di carattere predefinito, la pagina iniziale o le dimensioni delle finestre, in Visual Studio tale impostazione viene salvata nel file app.config con il tag <userSettings>.

Nota sulla sicurezza

Quando si archiviano stringhe di connessione in app.config, è opportuno adottare delle precauzioni per evitare di rivelare informazioni riservate, quali password o percorsi del server, nella stringa di connessione. Se si ricevono informazioni della stringa di connessione da un'origine esterna, quale un utente che immette un ID utente e una password, accertarsi che tra i valori utilizzati per costruire la stringa di connessione non siano presenti parametri aggiuntivi in grado di modificare il comportamento della connessione. Valutare l'utilizzo della funzionalità di configurazione protetta per crittografare le informazioni riservate nel file di configurazione. Per ulteriori informazioni, vedere Protezione delle informazioni di connessione (ADO.NET).

Utilizzo di file di impostazioni personalizzati

È possibile aggiungere file di impostazioni personalizzati al progetto per agevolare la gestione dei gruppi di impostazioni. Le impostazioni contenute in un unico file vengono caricate e salvate come unità. Di conseguenza, l'archiviazione delle impostazioni in file diversi per i gruppi di utilizzo frequente e di utilizzo non frequente può determinare un risparmio di tempo nel caricamento e nel salvataggio delle impostazioni.

Ad esempio, è possibile aggiungere un file quale SpecialSettings.settings al progetto. Mentre la classe SpecialSettings non è esposta nello spazio dei nomi My, Visualizza codice può leggere il file di impostazioni personalizzate contenente Partial Class SpecialSettings.

Progettazione impostazioni cerca innanzi tutto il file Settings.settings creato dal sistema del progetto, ovvero il file predefinito visualizzato nella scheda Impostazioni di Progettazione progetti. Settings.settings è situato nella cartella Progetti per i progetti Visual Basic e nella cartella Proprietà per i progetti Visual C#. Successivamente, Progettazione progetti cerca gli altri file di impostazioni nella cartella radice del progetto. Pertanto, è necessario inserirvi il file di impostazioni personalizzato. Se si aggiunge un file .settings in un altro punto del progetto, questo non verrà trovato da Progettazione progetti.

Accesso o modifica delle impostazioni dell'applicazione in fase di esecuzione in Visual Basic

Nei progetti Visual Basic è possibile accedere alle impostazioni dell'applicazione in fase di esecuzione utilizzando l'oggetto My.Settings. Nella pagina Impostazioni scegliere il pulsante Visualizza codice per visualizzare il file Settings.vb. Per ulteriori informazioni, vedere Procedura: accedere agli eventi di impostazione. Nel file Settings.vb viene definita la classe Settings che consente di gestire i seguenti eventi nella classe delle impostazioni: SettingChanging, PropertyChanged, SettingsLoaded e SettingsSaving. La classe Settings nel file Settings.vb è una classe parziale in cui viene visualizzato solo il codice di proprietà dell'utente, non l'intera classe generata. Per ulteriori informazioni sull'accesso alle impostazioni dell'applicazione mediante l'oggetto My.Settings, vedere Accesso alle impostazioni dell'applicazione (Visual Basic).

I valori di qualsiasi impostazione con ambito di utente che vengono modificati dall'utente in fase di esecuzione, ad esempio la posizione di un form, vengono archiviati in un file user.config. I valori predefiniti vengono salvati nel file app.config.

Se si modifica qualsiasi impostazione con ambito di utente in fase di esecuzione, ad esempio durante il test dell'applicazione, e si desidera ripristinare i valori predefiniti per queste impostazioni, scegliere il pulsante Sincronizza. Per ulteriori informazioni su questo controllo, vedere Pagina Impostazioni, Progettazione progetti.

È consigliabile utilizzare l'oggetto My.Settings e il file .settings predefinito per accedere alle impostazioni. Ciò perché è possibile utilizzare Progettazione impostazioni per assegnare proprietà alle impostazioni e le impostazioni utente vengono salvate automaticamente prima della chiusura dell'applicazione. L'applicazione Visual Basic, comunque, può accedere direttamente alle impostazioni. In quel caso è necessario accedere alla classe MySettings e utilizzare un file .settings personalizzato nella radice del progetto. È inoltre necessario salvare le impostazioni utente prima di terminare l'applicazione, come per le applicazioni C#, come illustrato nella sezione seguente.

Accesso o modifica delle impostazioni dell'applicazione in fase di esecuzione in Visual C#

In linguaggi diversi da Visual Basic, quali Visual C#, è necessario accedere direttamente alla classe Settings, come illustrato nell'esempio seguente relativo a Visual C#.

Properties.Settings.Default.FirstUserSetting = "abc";

È inoltre necessario chiamare in modo esplicito il metodo Save di questa classe wrapper per rendere persistenti le impostazioni utente. Questa operazione viene generalmente effettuata nel gestore eventi Closing del form principale. Nell'esempio seguente relativo a Visual C# viene illustrata una chiamata al metodo Save.

Properties.Settings.Default.Save();

Per un esempio specifico su come creare nuove impostazioni dell'applicazione e su come associarle alle proprietà di un form, vedere Procedura: creare le impostazioni delle applicazioni utilizzando la finestra di progettazione. Per ulteriori informazioni sull'accesso alle impostazioni dell'applicazione mediante la classe Settings, vedere Cenni preliminari sulle impostazioni delle applicazioni.

Vedere anche

Attività

Procedura: aggiungere o rimuovere impostazioni dell'applicazione

Procedura: accedere agli eventi di impostazione

Riferimenti

Pagina Impostazioni, Progettazione progetti

Concetti

Accesso alle impostazioni dell'applicazione (Visual Basic)

Altre risorse

Gestione delle impostazioni di un'applicazione