Dela via


Anvisningar: Skapa egenskapsrutnät för användare Instä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.

Kommentar

För att det här exemplet ska fungera måste programmet ha sina användarinställningar konfigurerade. Mer information finns i Hantera program Instä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 programomfattningsinställning är skrivskyddad, medan egenskapen för en användaromfattningsinställning är skrivskyddad. Mer information finns i My.Inställningar Objekt.

Kommentar

Du kan inte ändra eller spara värdena för programomfattningsinställningar vid 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 program Instä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 . I det BrowsableAttributes här exemplet anges egenskapen PropertyGrid till för UserScopedSettingAttribute att endast visa användarinställningsegenskaperna.

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 för att Form1 öppna koden för händelsehanteraren 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
    

    Kommentar

    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 How to: Persist User Inställningar in Visual Basic (Så här gör du: Spara användare Inställningar i Visual Basic).

Se även