Procedura: creare griglie di proprietà per impostazioni utente in Visual Basic

Aggiornamento: novembre 2007

È possibile creare una griglia delle proprietà per le impostazioni utente popolando un controllo PropertyGrid con le proprietà delle impostazioni utente dell'oggetto My.Settings.

Nota:
Affinché questo esempio funzioni, è necessario aver configurato le impostazioni utente sull'applicazione. Per informazioni sull'aggiunta delle impostazioni utente, vedere Procedura: aggiungere o rimuovere impostazioni dell'applicazione.

L'oggetto My.Settings espone ogni impostazione come una proprietà. Il nome della proprietà è uguale al nome dell'impostazione e il tipo di proprietà è uguale al tipo di impostazione. L'Ambito dell'impostazione determina se la proprietà è in sola lettura. La proprietà per un'impostazione relativa all'Applicazione è in sola lettura, mentre la proprietà per un impostazione relativa all'Utente è in lettura-scrittura. Per ulteriori informazioni, vedere Oggetto My.Settings.

Nota:
Non è possibile modificare o salvare i valori delle impostazioni relative all'applicazione in fase di esecuzione. Le impostazioni relative all'applicazione possono essere modificate solo in fase di creazione dell'applicazione mediante Progettazione progetti o modificando il file di configurazione dell'applicazione. Per ulteriori informazioni, vedere Gestione delle impostazioni di un'applicazione.

Nell'esempio riportato di seguito viene utilizzato un controllo PropertyGrid per accedere alle proprietà di impostazione utente dell'oggetto My.Settings. Per impostazione predefinita, nella PropertyGrid sono mostrate tutte le proprietà dell'oggetto My.Settings. Tuttavia, alle proprietà delle impostazioni utente è associato l'attributo UserScopedSettingAttribute. Nell'esempio riportato di seguito viene impostata la proprietà BrowsableAttributes della PropertyGrid su UserScopedSettingAttribute per visualizzare solo le proprietà delle impostazioni utente.

Per aggiungere una griglia delle proprietà delle impostazioni utente

1. Dalla Casella degli strumenti, aggiungere il controllo PropertyGrid all'area di progettazione dell'applicazione, considerata nell'esempio come Form1.

   Il nome predefinito del controllo property-grid è PropertyGrid1.

2. Fare doppio clic sull'area di progettazione per Form1 per aprire il codice per il gestore eventi di caricamento del form.

3. Impostare l'oggetto My.Settings come l'oggetto selezionato per la griglia delle proprietà.

   PropertyGrid1.SelectedObject = My.Settings
   

4. Configurare la griglia delle proprietà in modo da mostrare solo le impostazioni utente.

   ' Attribute for the user-scope settings.
   Dim userAttr As New System.Configuration.UserScopedSettingAttribute
   Dim attrs As New System.ComponentModel.AttributeCollection(userAttr)
   PropertyGrid1.BrowsableAttributes = attrs
   

   Nota:
   Per mostrare solo le impostazioni relative all'applicazione, utilizzare l'attributo ApplicationScopedSettingAttribute anziché UserScopedSettingAttribute.

Programmazione efficiente

Le impostazioni utente saranno salvate alla chiusura dell'applicazione. Per salvare immediatamente le impostazioni, chiamare il metodo My.Settings.Save, Per ulteriori informazioni, vedere Procedura: mantenere le impostazioni dell'utente in Visual Basic.

Vedere anche

Attività

Procedura: leggere le impostazioni dell'applicazione in Visual Basic

Procedura: modificare le impostazioni dell'utente in Visual Basic

Procedura: mantenere le impostazioni dell'utente in Visual Basic

Procedura: aggiungere o rimuovere impostazioni dell'applicazione

Riferimenti

Oggetto My.Settings

Altre risorse

Gestione delle impostazioni di un'applicazione