Condividi tramite

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

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

Annotazioni

Affinché questo esempio funzioni, l'applicazione deve avere le impostazioni utente configurate. Per altre informazioni, vedere Gestione delle impostazioni dell'applicazione (.NET).

L'oggetto My.Settings espone ogni impostazione come proprietà. Il nome della proprietà corrisponde al nome dell'impostazione e il tipo di proprietà corrisponde al tipo di impostazione. L'ambito dell'impostazione determina se la proprietà è di sola lettura; la proprietà per un'impostazione di ambito applicazione è di sola lettura, mentre la proprietà per un'impostazione ambito utente è di lettura/scrittura. Per altre informazioni, vedere Oggetto My.Settings.

Annotazioni

Non è possibile modificare o salvare i valori delle impostazioni dell'ambito dell'applicazione in fase di esecuzione. Le impostazioni dell'ambito dell'applicazione possono essere modificate solo quando si crea l'applicazione (tramite Progettazione progetti) o modificando il file di configurazione dell'applicazione. Per altre informazioni, vedere Gestione delle impostazioni dell'applicazione (.NET).

In questo esempio viene utilizzato un PropertyGrid controllo 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, viene impostata la proprietà BrowsableAttributes di PropertyGrid a UserScopedSettingAttribute per visualizzare solo le proprietà dell'impostazione utente.

Per aggiungere una griglia delle proprietà delle impostazioni utente

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

    Il nome predefinito del controllo property-grid è PropertyGrid1.

  2. Fare doppio clic sull'area di progettazione per Form1, aprire il codice per il gestore dell'evento di caricamento del modulo.

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

    PropertyGrid1.SelectedObject = My.Settings

  4. Configurare la griglia delle proprietà per visualizzare 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

    Annotazioni

    Per visualizzare solo le impostazioni dell'ambito applicazione, usare l'attributo ApplicationScopedSettingAttribute anziché UserScopedSettingAttribute.

Programmazione affidabile

L'applicazione salva le impostazioni utente quando l'applicazione viene arrestata. Per salvare immediatamente le impostazioni, chiamare il My.Settings.Save metodo . Per altre informazioni, vedere Procedura: Rendere persistenti le impostazioni utente in Visual Basic.

Vedere anche

  • Last updated on