Создание категории параметров

Статья
12/21/2023

В этом пошаговом руководстве вы создадите категорию параметров Visual Studio и используете ее для сохранения значений и восстановления значений из файла параметров. Категория параметров — это группа связанных свойств, которые отображаются как "точка пользовательских параметров"; то есть в качестве поля проверка в мастере импорта и экспорта Параметры. (Его можно найти на Меню инструментов.) Параметры сохраняются или восстанавливаются в качестве категории, а отдельные параметры не отображаются в мастере. Дополнительные сведения см. в статье Параметры среды.

Вы создаете категорию параметров, выпроизводя ее из DialogPage класса.

Чтобы запустить это пошаговое руководство, сначала необходимо завершить первый раздел страницы "Создание параметров". Результирующая сетка свойств Options позволяет проверять и изменять свойства в категории. После сохранения категории свойств в файле параметров просмотрите файл, чтобы узнать, как хранятся значения свойств.

Создание категории параметров

В этом разделе вы используете настраиваемую точку параметров для сохранения и восстановления значений категории параметров.

Создание категории параметров

Завершите страницу "Создание параметров".
Откройте ФАЙЛ VSPackage.resx и добавьте следующие три строковых ресурса:

Имя. Значение

106 Моя категория

107 Мои настройки

108 OptionInteger и OptionFloat

При этом создаются ресурсы, которые называют категорию "Моя категория", объект "My Параметры", а также описание категории "OptionInteger и OptionFloat".

Примечание.

Из этих трех, только имя категории не отображается в мастере импорта и экспорта Параметры.

В MyToolsOptionsPackage.cs добавьте float свойство с именем OptionFloat в OptionPageGrid класс, как показано в следующем примере.

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

Примечание.

Теперь OptionPageGrid категория "Моя категория" состоит из двух свойств и OptionInteger OptionFloat.

ProvideProfileAttribute MyToolsOptionsPackage Добавьте к классу и присвойте ему имя категории "Моя категория", присвойте ему имя объекта "My Параметры", а затем задайте значение true для объектаToolsOptionPage. Задайте для категорииResourceID, objectNameResourceID и DescriptionResourceID соответствующие идентификаторы ресурсов строки, созданные ранее.
```
[ProvideProfileAttribute(typeof(OptionPageGrid),
    "My Category", "My Settings", 106, 107, isToolsOptionPage:true, DescriptionResourceID = 108)]
```
Выполните сборку решения и запустите отладку. В экспериментальном экземпляре должно быть видно, что страница "Моя сетка " теперь имеет целые и плавающие значения.

Проверка файла параметров

В этом разделе вы экспортируете значения категорий свойств в файл параметров. Вы проверяете файл, а затем импортируете значения обратно в категорию свойств.

Запустите проект в режиме отладки, нажав клавишу F5. Это запускает экспериментальный экземпляр.
Откройте диалоговое окно "Параметры инструментов>".
В представлении дерева в левой области разверните раздел "Моя категория ", а затем щелкните "Моя страница сетки".
Измените значение OptionFloat на 3.1416 и OptionInteger на 12. Щелкните OK.
В меню Сервис выберите команду Импорт и экспорт параметров.

Откроется мастер импорта и экспорта Параметры.
Убедитесь, что выбраны параметры выбранной среды экспорта, а затем нажмите кнопку "Далее".

Откроется страница выбора Параметры для экспорта.
Нажмите кнопку "Моя Параметры".

Описание изменяется на OptionInteger и OptionFloat.
Убедитесь, что моя Параметры является единственной выбранной категорией, а затем нажмите кнопку "Далее".

Откроется страница "Имя" Параметры файла.
Назовите новый файл параметров My Параметры.vssettings и сохраните его в соответствующем каталоге. Нажмите кнопку Готово.

Файл .vssettings — это файл параметров Visual Studio. Схема файла открыта. Чаще всего схема соответствует XML-структуре, в которой каждая категория является тегом, который может содержать теги подкатегорий. Эти теги подкатеголии могут содержать теги значений свойств. Хотя большинство пакетов использует общую структуру, любой пакет в Visual Studio может внести в файл произвольный XML с помощью схемы, которую он выбрал.

Страница "Экспорт завершена " сообщает, что параметры успешно экспортированы.
В меню Файл наведите указатель мыши на пункт Открытьи выберите Файл. Найдите my Параметры.vssettings и откройте его.

Вы можете найти категорию свойств, экспортируемую в следующем разделе файла (идентификаторы GUID будут отличаться).
```
<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>
```
Обратите внимание, что полное имя категории формируется добавлением подчеркивания к имени категории, за которым следует имя объекта. OptionFloat и OptionInteger отображаются в категории вместе со своими экспортируемыми значениями.
Закройте файл параметров, не изменив его.
В меню "Сервис" выберите пункт "Параметры", разверните раздел "Моя категория", выберите "Моя страница сетки", а затем измените значение OptionFloat на 1.0 и OptionInteger на 1. Щелкните OK.
В меню "Сервис" нажмите кнопку "Импорт и экспорт Параметры", выберите "Импорт выбранных параметров среды" и нажмите кнопку "Далее".

Откроется страница "Сохранить текущую Параметры".
Нажмите кнопку "Нет", просто импортируйте новые параметры и нажмите кнопку "Далее".

Откроется страница выбора коллекции Параметры для импорта.
Выберите файл My Параметры.vssettings в узле "Мой Параметры" представления дерева. Если файл не отображается в представлении дерева, нажмите кнопку "Обзор " и найдите его. Нажмите кнопку Далее.

Откроется диалоговое окно "Выбор Параметры для импорта".
Убедитесь, что выбрана моя Параметры, а затем нажмите кнопку "Готово". Когда появится страница "Импорт завершена", нажмите кнопку "Закрыть".
В меню "Сервис" щелкните "Параметры", разверните раздел "Моя категория", щелкните "Моя сетка" и убедитесь, что значения категорий свойств восстановлены.