Procedura: creare griglie di proprietà per impostazioni utente in Visual Basic
È 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 ulteriori informazioni, vedere Gestione delle impostazioni di un'applicazione.
L'oggetto My.Settings visualizza ogni impostazione come proprietà. Il nome della proprietà corrisponde al nome dell'impostazione e il tipo di proprietà 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
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.
Fare doppio clic sull'area di progettazione per Form1 per aprire il codice per il gestore eventi di caricamento del form.
Impostare l'oggetto My.Settings come l'oggetto selezionato per la griglia delle proprietà.
PropertyGrid1.SelectedObject = My.SettingsConfigurare 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 = attrsNota
Per mostrare solo le impostazioni con ambito di 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