Freigeben über


Gewusst wie: 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.

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

  1. 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.

  2. 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.

  3. Legen Sie das My.Settings-Objekt als ausgewähltes 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
    

    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

Aufgaben

Gewusst wie: Lesen von Anwendungseinstellungen in Visual Basic

Gewusst wie: Ändern von Benutzereinstellungen in Visual Basic

Gewusst wie: Beibehalten von Benutzereinstellungen in Visual Basic

Gewusst wie: Hinzufügen oder Entfernen von Anwendungseinstellungen

Referenz

My.Settings-Objekt (Visual Basic)

Weitere Ressourcen

Verwalten von Anwendungseinstellungen