Anvisningar: Skapa egenskapsrutnät för användarinställningar i Visual Basic

Du kan skapa ett egenskapsrutnät för användarinställningar genom att fylla i en PropertyGrid kontroll med användarens inställningsegenskaper för My.Settings objektet.

Anmärkning

För att det här exemplet ska fungera måste programmet ha sina användarinställningar konfigurerade. Mer information finns i Hantera programinställningar (.NET).

Objektet My.Settings exponerar varje inställning som en egenskap. Egenskapsnamnet är samma som inställningsnamnet och egenskapstypen är samma som inställningstypen. Inställningens omfång avgör om egenskapen är skrivskyddad. Egenskapen för en inställning med programomfattning är skrivskyddad, medan egenskapen för en inställning med användaromfattning är läs- och skrivbar. Mer information finns i Objektet My.Settings.

Anmärkning

Du kan inte ändra eller spara värdena för inställningar med programomfattning under körning. Inställningar för programomfattning kan bara ändras när du skapar programmet (via Projektdesignern) eller genom att redigera programmets konfigurationsfil. Mer information finns i Hantera programinställningar (.NET).

I det här exemplet används en PropertyGrid kontroll för att komma åt objektets användarinställningsegenskaper My.Settings . Som standard PropertyGrid visar alla egenskaper för My.Settings objektet. Användarinställningsegenskaperna har dock attributet UserScopedSettingAttribute . Detta exempel anger egenskapen BrowsableAttributes för PropertyGrid till UserScopedSettingAttribute för att endast visa användarinställningsegenskaper.

Så här lägger du till ett egenskapsrutnät för användarinställningar

  1. Lägg till PropertyGrid-kontrollen från verktygslådan till designytan för ditt program, som här antas vara Form1.

    Standardnamnet för kontrollen property-grid är PropertyGrid1.

  2. Dubbelklicka på designytan på Form1 för att öppna koden för formulärets händelsehanterare för formulärinläsning.

  3. Ange objektet My.Settings som markerat objekt för egenskapsrutnätet.

    PropertyGrid1.SelectedObject = My.Settings
    
  4. Konfigurera egenskapsrutnätet så att endast användarinställningarna visas.

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

    Anmärkning

    Om du bara vill visa inställningarna för programomfattningen använder du ApplicationScopedSettingAttribute attributet i stället för UserScopedSettingAttribute.

Robust Programmering

Programmet sparar användarinställningarna när programmet stängs av. Om du vill spara inställningarna omedelbart anropar du My.Settings.Save metoden. Mer information finns i Så här: Spara användarinställningar i Visual Basic.

Se även