Freigeben über

Vorgehensweise: Erstellen von Eigenschaftenrastern für Benutzereinstellungen in Visual Basic

Sie können ein Eigenschaftenraster für Benutzereinstellungen erstellen, indem Sie ein PropertyGrid Steuerelement mit den Benutzereinstellungseigenschaften des My.Settings Objekts auffüllen.

Hinweis

Damit dieses Beispiel funktioniert, muss Ihre Anwendung ihre Benutzereinstellungen konfiguriert haben. Weitere Informationen finden Sie unter Verwalten von Anwendungseinstellungen (.NET).

Das My.Settings Objekt macht jede Einstellung als Eigenschaft verfügbar. Der Eigenschaftsname ist identisch mit dem Einstellungsnamen, und der Eigenschaftstyp entspricht dem Einstellungstyp. Der Bereich der Einstellung gibt an, ob die Eigenschaft schreibgeschützt ist; die Eigenschaft für den Bereich Anwendung ist schreibgeschützt, während die Eigenschaft für die Bereichseinstellung Benutzer über einen Lese-/Schreibzugriff verfügt. Weitere Informationen finden Sie unter My.Settings-Objekt.

Hinweis

Sie können die Werte der Anwendungsbereichseinstellungen zur Laufzeit nicht ändern oder speichern. Anwendungsbereichseinstellungen können nur geändert werden, wenn Sie die Anwendung (über den Project Designer) erstellen oder die Konfigurationsdatei der Anwendung bearbeiten. Weitere Informationen finden Sie unter Verwalten von Anwendungseinstellungen (.NET).

In diesem Beispiel wird ein PropertyGrid Steuerelement verwendet, um auf die Eigenschaften der Benutzereinstellung des My.Settings Objekts zuzugreifen. In der Standardeinstellung zeigt PropertyGrid alle Eigenschaften des My.Settings-Objekts an. Die Benutzereinstellungseigenschaften weisen jedoch das UserScopedSettingAttribute Attribut auf. In diesem Beispiel wird die BrowsableAttributes-Eigenschaft des PropertyGrid auf UserScopedSettingAttribute gesetzt, um nur die Eigenschaften der Benutzereinstellung anzuzeigen.

So fügen Sie ein Eigenschaftsgrid für Benutzereinstellungen hinzu

  1. Fügen Sie das PropertyGrid-Steuerelement aus der Toolbox zur Entwurfsoberfläche für Ihre Anwendung hinzu, vorausgesetzt, dies ist hier Form1.

    Der Standardname des Eigenschaftenraster-Steuerelements lautet PropertyGrid1.

  2. Doppelklicken Sie auf die Entwurfsoberfläche von Form1, um den Code für den Ereignishandler für das Laden des Formulars zu öffnen.

  3. Legen Sie das My.Settings Objekt als das ausgewählte Objekt für das Eigenschaftenraster fest.

    PropertyGrid1.SelectedObject = My.Settings

  4. Konfigurieren Sie das Eigenschaftenraster so, dass nur die Benutzereinstellungen angezeigt werden.

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

    Hinweis

    Um nur die Anwendungsbereichseinstellungen anzuzeigen, verwenden Sie das ApplicationScopedSettingAttribute Attribut anstelle von UserScopedSettingAttribute.

Robuste Programmierung

Die Anwendung speichert die Benutzereinstellungen, wenn die Anwendung heruntergefahren wird. Rufen Sie die My.Settings.Save Methode auf, um die Einstellungen sofort zu speichern. Weitere Informationen finden Sie unter How to: Persist User Settings in Visual Basic.

Siehe auch