Condividi tramite

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

  • Articolo

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

Nota

Affinché l'esempio funzioni, per l'applicazione devono essere state configurate le impostazioni utente. Per altre informazioni, vedere Gestione delle impostazioni di un'applicazione (.NET).

L'oggetto My.Settings espone ogni impostazione come una 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à è di sola lettura. La proprietà di un'impostazione dell'ambito dell'applicazione è di sola lettura, mentre la proprietà dell'ambito dell'utente-è di lettura e scrittura. Per altre informazioni, vedere Oggetto My.Settings.

Nota

Non è possibile modificare o salvare i valori delle impostazioni dell'ambito dell'applicazione in fase di esecuzione. È possibile modificare le impostazioni dell'ambito dell'applicazione quando si crea l'applicazione tramite Creazione progetti o modificando il file di configurazione dell'applicazione. Per altre informazioni, vedere Gestione delle impostazioni di un'applicazione (.NET).

In questo esempio viene usato un controllo PropertyGrid per accedere alle proprietà dell'impostazione utente dell'oggetto My.Settings. Per impostazione predefinita, PropertyGrid mostra tutte le proprietà dell'oggetto My.Settings. Tuttavia, le proprietà dell'impostazione utente hanno l'attributo UserScopedSettingAttribute. In questo esempio la proprietà BrowsableAttributes di PropertyGrid viene impostata su UserScopedSettingAttribute per visualizzare solo le proprietà dell'impostazione utente.

Per aggiungere una griglia delle proprietà dell'impostazione utente

  1. Aggiungere il controllo PropertyGrid dalla casella degli strumenti all'area di progettazione dell'applicazione, presupponendo che questo campo sia Form1.

    Il nome predefinito del controllo PropertyGrid è PropertyGrid1.

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

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

    PropertyGrid1.SelectedObject = My.Settings

  4. Configurare la griglia delle proprietà affinché mostri 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 visualizzare solo le impostazioni dell'ambito applicazione, usare l'attributo ApplicationScopedSettingAttribute anziché UserScopedSettingAttribute.

Programmazione efficiente

Alla chiusura dell'applicazione vengono salvate le impostazioni utente. Per salvare immediatamente le impostazioni, chiamare il metodo My.Settings.Save. Per altre informazioni, vedere Procedura: Mantenere le impostazioni dell'utente in Visual Basic.

Vedi anche