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

  • Článek

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 najdete v tématu My.Nastavení Objekt.

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 BrowsableAttributes vlastnost PropertyGrid nastaví tak, aby UserScopedSettingAttribute zobrazovala 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 obslužné rutiny 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é