Vytvoření kategorie nastavení

Článek
12/21/2023

V tomto názorném postupu vytvoříte kategorii nastavení sady Visual Studio a použijete ji k uložení hodnot do a obnovení hodnot ze souboru nastavení. Kategorie nastavení je skupina souvisejících vlastností, které se zobrazují jako "vlastní bod nastavení"; to znamená, že jako zaškrtávací políčko v průvodci importem a exportem Nastavení. (Najdete ho naNabídka Nástroje.) Nastavení se uloží nebo obnoví jako kategorie a v průvodci se nezobrazí jednotlivá nastavení. Další informace najdete v tématu Nastavení prostředí.

Kategorii nastavení vytvoříte odvozením z DialogPage třídy.

Chcete-li spustit tento názorný postup, musíte nejprve dokončit první část stránky Vytvořit možnosti. Výsledná mřížka vlastností Možnosti umožňuje prozkoumat a změnit vlastnosti v kategorii. Po uložení kategorie vlastnosti do souboru nastavení zkontrolujete soubor, abyste viděli, jak se hodnoty vlastností ukládají.

Vytvoření kategorie nastavení

V této části použijete vlastní bod nastavení k uložení a obnovení hodnot kategorie nastavení.

Vytvoření kategorie nastavení

Dokončete stránku Vytvořit možnosti.
Otevřete soubor VSPackage.resx a přidejte tyto tři řetězcové prostředky:

Jméno Hodnota

106 Moje kategorie

107 Moje Nastavení

108 OptionInteger a OptionFloat

Tím se vytvoří prostředky, které pojmenují kategorii My Category, objekt My Nastavení a popis kategorie OptionInteger a OptionFloat.

Poznámka:

Ztěchto Nastavení ch

V MyToolsOptionsPackage.cs přidejte vlastnost pojmenovanou float OptionFloat do OptionPageGrid třídy, jak je znázorněno v následujícím příkladu.

public class OptionPageGrid : DialogPage
{
    private int optionInt = 256;
    private float optionFloat = 3.14F;

    [Category("My Options")]
    [DisplayName("My Integer option")]
    [Description("My integer option")]
    public int OptionInteger
    {
        get { return optionInt; }
        set { optionInt = value; }
    }
    [Category("My Options")]
    [DisplayName("My Float option")]
    [Description("My float option")]
    public float OptionFloat
    {
        get { return optionFloat; }
        set { optionFloat = value; }
    }
}

Poznámka:

Kategorie OptionPageGrid s názvem "Moje kategorie" se nyní skládá ze dvou vlastností OptionInteger a OptionFloat.

ProvideProfileAttribute Přidejte do MyToolsOptionsPackage třídy a dejte mu CategoryName "My Category", dejte mu ObjectName "My Nastavení" a nastavte isToolsOptionPage na true. Nastavte categoryResourceID, objectNameResourceID a DescriptionResourceID na odpovídající ID prostředků řetězce vytvořené dříve.
```
[ProvideProfileAttribute(typeof(OptionPageGrid),
    "My Category", "My Settings", 106, 107, isToolsOptionPage:true, DescriptionResourceID = 108)]
```
Sestavte projekt a spusťte ladění. V experimentální instanci byste měli vidět, že stránka Mřížka teď obsahuje celočíselné i plovoucí hodnoty.

Prozkoumání souboru nastavení

V této části exportujete hodnoty kategorií vlastností do souboru nastavení. Zkontrolujete soubor a pak importujete hodnoty zpět do kategorie vlastnosti.

Stisknutím klávesy F5 spusťte projekt v režimu ladění. Tím se spustí experimentální instance.
Otevřete dialogové okno Možnosti nástrojů>.
Ve stromovém zobrazení v levém podokně rozbalte položku Moje kategorie a potom klikněte na Položku Mřížka.
Změňte hodnotu OptionFloat na 3.1416 a OptionInteger na 12. Klikněte na OK.
V nabídce Nástroje klepněte na tlačítko Importovat a exportovat Nastavení.

Zobrazí se průvodce importem a exportem Nastavení.
Ujistěte se, že je vybraná možnost Exportovat vybrané nastavení prostředí, a potom klepněte na tlačítko Další.

Zobrazí se stránka Zvolit Nastavení k exportu.
Klikněte na Moje Nastavení.

Popis se změní na OptionInteger a OptionFloat.
Ujistěte se, že je Nastavení jedinou vybranou kategorií, a klikněte na tlačítko Další.

Zobrazí se stránka Název souboru Nastavení.
Pojmenujte nový soubor nastavení My Nastavení.vssettings a uložte ho do příslušného adresáře. Klikněte na Finish (Dokončit).

Soubor .vssettings je soubor nastavení sady Visual Studio. Schéma souboru je otevřené. Schéma se nejčastěji řídí strukturou XML, kde každá kategorie je značka, která může sama obsahovat značky podkategorie. Tyto značky podkategorie můžou obsahovat značky hodnot vlastností. Většina balíčků sice používá společnou strukturu, ale každý balíček v sadě Visual Studio může do souboru přispívat libovolným kódem XML s zvoleným schématem.

Stránka Exportovat dokončené sestavy, které vaše nastavení úspěšně exportovalo.
V nabídce Soubor přejděte na příkaz Otevřít a klepněte na tlačítko Soubor. Vyhledejte my Nastavení.vssettings a otevřete ho.

Kategorii vlastností, kterou jste vyexportovali, najdete v následující části souboru (identifikátory GUID se budou lišit).
```
<Category name="My Category_My Settings"
      Category="{4802bc3e-3d9d-4591-8201-23d1a05216a6}"
      Package="{6bb6942e-014c-489e-a612-a935680f703d}"
      RegisteredName="My Category_My Settings">
      PackageName="MyToolsOptionsPackage">
   <PropertyValue name="OptionFloat">3.1416</PropertyValue>
   <PropertyValue name="OptionInteger">12</PropertyValue>
</Category>
```
Všimněte si, že úplný název kategorie je vytvořen přidáním podtržítka k názvu kategorie následovaného názvem objektu. OptionFloat a OptionInteger se zobrazí v kategorii společně s jejich exportovanými hodnotami.
Zavřete soubor nastavení beze změny.
V nabídce Nástroje klepněte na tlačítko Možnosti, rozbalte položku Moje kategorie, klepněte na položku Stránka mřížky a potom změňte hodnotu OptionFloat na 1.0 a OptionInteger na 1. Klikněte na OK.
V nabídce Nástroje klepněte na tlačítko Importovat a exportovat Nastavení, vyberte Importovat vybrané nastavení prostředí a potom klepněte na tlačítko Další.

Zobrazí se stránka Uložit aktuální Nastavení.
Vyberte Ne, stačí importovat nová nastavení a potom kliknout na Tlačítko Další.

Zobrazí se stránka Zvolit kolekci Nastavení k importu.
V uzlu Moje Nastavení stromového zobrazení vyberte soubor My Nastavení.vssettings. Pokud se soubor ve stromovém zobrazení nezobrazí, klikněte na Procházet a vyhledejte ho. Klikněte na tlačítko Další.

Zobrazí se dialogové okno Zvolit Nastavení k importu.
Ujistěte se, že je vybraná Nastavení, a potom klepněte na tlačítko Dokončit. Po zobrazení stránky Importovat dokončeno klepněte na tlačítko Zavřít.
V nabídce Nástroje klepněte na tlačítko Možnosti, rozbalte položku Moje kategorie, klepněte na položku Stránka mřížky a ověřte, zda byly obnoveny hodnoty kategorií vlastností.