Gewusst wie: Erstellen von Eigenschaftenrastern für Benutzereinstellungen in Visual Basic

Artikel
08/15/2011

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

Tipp

Damit dieses Beispiel ausgeführt werden kann, muss die Anwendung über konfigurierte Benutzereinstellungen verfügen. Informationen zum Hinzufügen von Benutzereinstellungen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Anwendungseinstellungen.

Das My.Settings-Objekt macht alle Einstellungen als Eigenschaft verfügbar. Der Eigenschaftenname entspricht dem Namen der Einstellung, und der Eigenschaftentyp entspricht dem Typ der Einstellung. Der Bereich einer Einstellung bestimmt, ob die zugehörige Eigenschaft schreibgeschützt ist: Die Eigenschaft für eine Einstellung mit dem Bereich Anwendung ist schreibgeschützt, während die Eigenschaft für eine Einstellung mit dem Bereich Benutzer Lese-/Schreibzugriff ermöglicht. Weitere Informationen finden Sie unter My.Settings-Objekt (Visual Basic).

Tipp

Werte von Einstellungen, die für eine gesamte Anwendung gültig sind, können zur Laufzeit nicht geändert oder gespeichert werden. Einstellungen, die für eine gesamte Anwendung gültig sind, können beim Erstellen der Anwendung im Projekt-Designer) oder später durch Bearbeiten der Anwendungskonfigurationsdatei geändert werden. Weitere Informationen finden Sie unter Verwalten von Anwendungseinstellungen.

In diesem Beispiel wird ein PropertyGrid-Steuerelement verwendet, um auf die Benutzereinstellungseigenschaften des My.Settings-Objekts zuzugreifen. In der Standardeinstellung zeigt das PropertyGrid alle Eigenschaften des My.Settings-Objekts an. In den Benutzereinstellungseigenschaften ist jedoch auch das UserScopedSettingAttribute-Attribut verfügbar. In diesem Beispiel wird die BrowsableAttributes-Eigenschaft von PropertyGrid auf UserScopedSettingAttribute festgelegt, um ausschließlich die Benutzereinstellungseigenschaften anzuzeigen.

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

Fügen Sie der Entwurfsoberfläche der Anwendung (hier: Form1) das PropertyGrid-Steuerelement aus der Toolbox hinzu.

Der Standardname des Steuerelements für das Eigenschaftenraster ist PropertyGrid1.
Doppelklicken Sie auf die Entwurfsoberfläche für Form1, um den Code für den Ereignishandler zu öffnen, der dem Laden des Formulars zugeordnet ist.
Legen Sie das My.Settings-Objekt als ausgewähltes Objekt für das Eigenschaftenraster fest.
```
PropertyGrid1.SelectedObject = My.Settings
```
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
```
Tipp

Wenn nur die Einstellungen angezeigt werden sollen, die für die gesamte Anwendung gültig sind, verwenden Sie statt des UserScopedSettingAttribute-Attributs das ApplicationScopedSettingAttribute-Attribut.

Robuste Programmierung

Die Benutzereinstellungen werden beim Beenden der Anwendung gespeichert. Wenn Sie die Einstellungen sofort speichern möchten, rufen Sie die My.Settings.Save-Methode auf. Weitere Informationen finden Sie unter Gewusst wie: Beibehalten von Benutzereinstellungen in Visual Basic.

Siehe auch

Freigeben über

Gewusst wie: Erstellen von Eigenschaftenrastern für Benutzereinstellungen in Visual Basic

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

Robuste Programmierung

Siehe auch

Aufgaben

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen