Sdílet prostřednictvím


Postupy: Vytváření mřížek vlastností pro uživatelská nastavení v jazyce Visual Basic

Mřížku vlastností pro uživatelská nastavení můžete vytvořit vyplněním PropertyGrid ovládacího prvku vlastnostmi nastavení uživatele objektu My.Settings .

Poznámka:

Aby tento příklad fungoval, musí mít vaše aplikace nakonfigurovaná uživatelská nastavení. Další informace naleznete v tématu Správa nastavení aplikace (.NET).

Objekt My.Settings zveřejňuje každé nastavení jako vlastnost. Název vlastnosti je stejný jako název nastavení a typ vlastnosti je stejný jako typ nastavení. Obor nastavení určuje, zda je vlastnost určena jen pro čtení; vlastnost pro nastavení oboru aplikace je jen pro čtení, zatímco vlastnost pro nastavení oboru uživatele je pro čtení i zápis. Další informace naleznete v tématu My.Settings Object.

Poznámka:

Hodnoty nastavení oboru aplikace nelze změnit ani uložit za běhu. Nastavení oboru aplikace lze změnit pouze při vytváření aplikace (prostřednictvím Návrháře projektu) nebo úpravou konfiguračního souboru aplikace. Další informace naleznete v tématu Správa nastavení aplikace (.NET).

Tento příklad používá PropertyGrid ovládací prvek pro přístup k vlastnostem nastavení uživatele objektu My.Settings . Ve výchozím nastavení se PropertyGrid zobrazí všechny vlastnosti objektu My.Settings . Vlastnosti uživatelského nastavení však mají UserScopedSettingAttribute atribut. V tomto příkladu se vlastnost BrowsableAttributes objektu PropertyGrid nastaví na UserScopedSettingAttribute, aby se zobrazovaly pouze vlastnosti nastavení uživatele.

Přidání mřížky vlastností nastavení uživatele

  1. Přidejte ovládací prvek PropertyGrid z panelu nástrojů na návrhovou plochu pro vaši aplikaci, předpokládá se zde být Form1.

    Výchozí název ovládacího prvku property-grid je PropertyGrid1.

  2. Poklikáním na návrhovou plochu Form1 otevřete kód pro obsluhu události načítání formuláře.

  3. Nastavte My.Settings objekt jako vybraný objekt pro mřížku vlastností.

    PropertyGrid1.SelectedObject = My.Settings
    
  4. Nakonfigurujte mřížku vlastností tak, aby zobrazovala pouze uživatelská nastavení.

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

    Poznámka:

    Chcete-li zobrazit pouze nastavení oboru aplikace, použijte ApplicationScopedSettingAttribute atribut místo UserScopedSettingAttribute.

Robustní programování

Aplikace uloží uživatelská nastavení, když se aplikace vypne. Pokud chcete nastavení uložit okamžitě, zavolejte metodu My.Settings.Save . Další informace naleznete v tématu Postupy: Zachování uživatelského nastavení v jazyce Visual Basic.

Viz také