Tworzenie kategorii ustawień

Artykuł
12/21/2023

W tym przewodniku utworzysz kategorię ustawień programu Visual Studio i użyjesz jej do zapisywania wartości w pliku ustawień i przywracania ich z pliku ustawień. Kategoria ustawień to grupa powiązanych właściwości, które są wyświetlane jako "punkt ustawień niestandardowych"; oznacza to, że jako pole wyboru w kreatorze importu i eksportu Ustawienia. (Możesz go znaleźć na stronie Menu narzędzia.) Ustawienia są zapisywane lub przywracane jako kategoria, a poszczególne ustawienia nie są wyświetlane w kreatorze. Aby uzyskać więcej informacji, zobacz Ustawienia środowiska.

Kategorię ustawień można utworzyć, wyprowadzając ją z DialogPage klasy .

Aby rozpocząć ten przewodnik, należy najpierw ukończyć pierwszą sekcję strony Tworzenie opcji. Wynikowa siatka właściwości Opcje umożliwia sprawdzenie i zmianę właściwości w kategorii. Po zapisaniu kategorii właściwości w pliku ustawień sprawdź plik, aby zobaczyć, jak są przechowywane wartości właściwości.

Tworzenie kategorii ustawień

W tej sekcji użyjesz punktu ustawień niestandardowych, aby zapisać i przywrócić wartości kategorii ustawień.

Aby utworzyć kategorię ustawień

Ukończ stronę Tworzenie opcji.
Otwórz plik VSPackage.resx i dodaj następujące trzy zasoby ciągów:

Nazwa/nazwisko Wartość

106 Moja kategoria

107 Moje Ustawienia

108 OptionInteger i OptionFloat

Spowoduje to utworzenie zasobów o nazwie kategorii "Moja kategoria", obiektu "My Ustawienia" oraz opisu kategorii "OptionInteger and OptionFloat".

Uwaga

Spośród tych trzech tylko nazwa kategorii nie jest wyświetlana w kreatorze Importuj i Eksportuj Ustawienia.

W MyToolsOptionsPackage.cs dodaj float właściwość o nazwie OptionFloat do OptionPageGrid klasy, jak pokazano w poniższym przykładzie.

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; }
    }
}

Uwaga

Kategoria OptionPageGrid o nazwie "Moja kategoria" składa się teraz z dwóch właściwości OptionInteger i OptionFloat.

Dodaj element ProvideProfileAttribute do MyToolsOptionsPackage klasy i nadaj jej nazwę CategoryName "Moja kategoria", nadaj jej nazwę ObjectName "My Ustawienia", a następnie ustaw właściwość isToolsOptionPage na true. Ustaw wartości categoryResourceID, objectNameResourceID i DescriptionResourceID na utworzone wcześniej identyfikatory zasobów ciągu.
```
[ProvideProfileAttribute(typeof(OptionPageGrid),
    "My Category", "My Settings", 106, 107, isToolsOptionPage:true, DescriptionResourceID = 108)]
```
Skompiluj projekt i rozpocznij debugowanie. W wystąpieniu eksperymentalnym powinna być widoczna informacja, że strona Moja siatka ma teraz zarówno wartości całkowite, jak i zmiennoprzecinkowe.

Sprawdzanie pliku ustawień

W tej sekcji wyeksportujesz wartości kategorii właściwości do pliku ustawień. Zbadasz plik, a następnie zaimportujesz wartości z powrotem do kategorii właściwości.

Uruchom projekt w trybie debugowania, naciskając klawisz F5. Spowoduje to uruchomienie wystąpienia eksperymentalnego.
Otwórz okno dialogowe Opcje narzędzi>.
W widoku drzewa w okienku po lewej stronie rozwiń węzeł Moja kategoria , a następnie kliknij pozycję Moja strona siatki.
Zmień wartość opcjiFloat na 3.1416 i OptionInteger na 12. Kliknij przycisk OK.
W menu Narzędzia kliknij pozycję Importuj i eksportuj Ustawienia.

Zostanie wyświetlony kreator importowania i eksportowania Ustawienia.
Upewnij się, że wybrano opcję Eksportuj wybrane ustawienia środowiska, a następnie kliknij przycisk Dalej.

Zostanie wyświetlona strona Wybieranie Ustawienia do eksportu.
Kliknij pozycję Mój Ustawienia.

Opis zmienia się na OptionInteger i OptionFloat.
Upewnij się, że moja Ustawienia jest jedyną wybraną kategorią, a następnie kliknij przycisk Dalej.

Zostanie wyświetlona strona Nazwa Pliku Ustawienia.
Nadaj nowemu plikowi ustawień nazwę My Ustawienia.vssettings i zapisz go w odpowiednim katalogu. Kliknij przycisk Zakończ.

Plik .vssettings jest plikiem ustawień programu Visual Studio. Schemat pliku jest otwarty. Najczęściej schemat jest zgodny ze strukturą XML, w której każda kategoria jest tagiem, który może zawierać tagi podkategorii. Te tagi kategorii podrzędnej mogą zawierać tagi wartości właściwości. Podczas gdy większość pakietów używa wspólnej struktury, każdy pakiet w programie Visual Studio może współtworzyć dowolny kod XML do pliku przy użyciu wybranego schematu.

Strona Eksportowanie ukończone raportuje, że ustawienia zostały pomyślnie wyeksportowane.
W menu Plik wskaż polecenie Otwórz, a następnie kliknij pozycję Plik. Znajdź plik My Ustawienia.vssettings i otwórz go.

Kategorię właściwości wyeksportowaną można znaleźć w poniższej sekcji pliku (identyfikatory GUID będą się różnić).
```
<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>
```
Zwróć uwagę, że pełna nazwa kategorii jest tworzona przez dodanie podkreślenia do nazwy kategorii, po której następuje nazwa obiektu. OpcjaFloat i OptionInteger są wyświetlane w kategorii wraz z wyeksportowanymi wartościami.
Zamknij plik ustawień bez jego zmiany.
W menu Narzędzia kliknij pozycję Opcje, rozwiń węzeł Moja kategoria, kliknij pozycję Moja strona siatki, a następnie zmień wartość opcjiFloat na 1.0 i OptionInteger na 1. Kliknij przycisk OK.
W menu Narzędzia kliknij pozycję Importuj i eksportuj Ustawienia, wybierz pozycję Importuj wybrane ustawienia środowiska, a następnie kliknij przycisk Dalej.

Zostanie wyświetlona strona Zapisz bieżący Ustawienia.
Wybierz pozycję Nie, po prostu zaimportuj nowe ustawienia , a następnie kliknij przycisk Dalej.

Zostanie wyświetlona strona Wybierz kolekcję Ustawienia do zaimportowania.
Wybierz plik My Ustawienia.vssettings w węźle Mój Ustawienia widoku drzewa. Jeśli plik nie jest wyświetlany w widoku drzewa, kliknij przycisk Przeglądaj i znajdź go. Kliknij przycisk Dalej.

Zostanie wyświetlone okno dialogowe Wybieranie Ustawienia do zaimportowania.
Upewnij się, że wybrano pozycję Mój Ustawienia, a następnie kliknij przycisk Zakończ. Po wyświetleniu strony Importowanie ukończone kliknij przycisk Zamknij.
W menu Narzędzia kliknij pozycję Opcje, rozwiń węzeł Moja kategoria, kliknij pozycję Moja strona siatki i sprawdź, czy wartości kategorii właściwości zostały przywrócone.