Регистрация пользовательские Параметры страницы
Для страницы Сервис параметры, которые должны быть доступны для пользователей и автоматизация поддержки, он должен быть правильно зарегистрировать Visual Studio с интегрированной средой разработки (ide).
Страницы Сервис параметры на основе управляемых области пакета, зарегистрированных путем применения экземпляр ProvideOptionPageAttribute в VSPackage, предоставляющий страницу. Поддержка автоматизации отображается путем задания свойства SupportsAutomation к true.
Регистрация страницы " сервис Параметры "
Интегрировать настраиваемую страницу Сервис параметры с Visual Studio требует создания записей реестра в следующем расположении: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия>\ToolsOptionsPages, где <Версия> — это версия Visual Studio, например 8.0.
Запись имеет первичный ключ с категорией (<PageCategory>) страницы Сервис параметры и подраздел содержит имя подкатегории страницы (<PageSubCategory>).
Например, страница Сервис параметры указанной строкой, TextEditor.Basic, имеет =textEditor <PageCategory> раздела реестра с подразделом <PageSubCategory>=Basic.
Структура записи реестра ниже:
HKLM\Software\Microsoft\VisualStudio\<Версия>\ToolsOptionsPages\
<PageCategory> = '#12345'
Package = '{XXXXXX XXXX XXXX XXXX XXXXXXXXX}'
ResourcePackage = '{YYYYYY YYYY YYYY YYYY YYYYYYYYY}'
HKLM\Software\Microsoft\VisualStudio\<Версия>\ToolsOptionsPages\<PageCategory>
<PageSubCategory>> = '#67890'
Page = '{ZZZZZZ ZZZZ ZZZZ ZZZZ ZZZZZZZZZ}'
Package = '{AAAAAA AAAA AAAA AAAA AAAAAAAAA}'
ResourcePackage = '{BBBBBB BBBB BBBB BBBB BBBBBBBBB}'
NoShowAllView = 0/1
В следующей таблице перечислены значения в разделе реестра HKLM\Software\Microsoft\VisualStudio\<Версия>\ToolsOptionsPages\<PageCategory>.
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
(Значение по умолчанию) |
REG_SZ |
Каноническое имя категории пользовательской страницы Сервис параметры |
Имя клавиши, <PageCategory>, каноническое нелокализованное имя категории страницы Сервис параметры. Примечание Если автоматизация поддерживается, то канонические non-локализованные имена категорий и подкатегорий используются, чтобы получить коллекцию Properties страницы Сервис параметры.Дополнительные сведения см. в разделе С помощью страницы параметров. Для реализаций на основе управляемых области пакета, > <PageCategory получено из аргументов categoryName в конструктор ProvideOptionPageAttribute. Стрелка может быть пустой или она может содержать идентификатор ссылки на локализованную строку в реализации вспомогательной библиотеки DLL. Для реализаций на основе управляемых области пакета, это значение получено из аргументов categoryResourceID в конструктор ProvideOptionPageAttribute. |
Пакет |
REG_SZ |
GUID |
Идентификатор GUID VSPackage, реализующий пользовательскую страницу Сервис параметры. Реализации на основе управляемых области пакета с помощью отражения использования ProvideOptionPageAttribute для получения этого значения. |
ResourcePackage |
REG_SZ |
GUID |
Необязательный. Вспомогательной библиотеки DLL, содержащей локализованные строки, если при реализации VSPackage не передает их. Управляемые границы пакета используют отражение для получения правильного пакет ресурсов, поэтому ProvideOptionPageAttribute не устанавливает этот аргумент. |
В следующей таблице перечислены значения в разделе реестра HKLM\Software\Microsoft\VisualStudio\<Версия>\ToolsOptionsPages\<PageCategory>\<PageSubCategory>.
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
(Значение по умолчанию) |
REG_SZ |
Каноническое имя подкатегории пользовательской страницы Сервис параметры |
Имя клавиш, > <PageSubCategory, каноническое нелокализованное имя подкатегории страницы Сервис параметры. Примечание Если автоматизация поддерживается, то канонические non-локализованные имена категорий и подкатегорий используются, чтобы получить коллекцию Properties страницы Сервис параметры.Дополнительные сведения см. в разделе С помощью страницы параметров. Для реализаций на основе управляемых области пакета, > <PageSubegory получено из аргументов pageName в конструктор ProvideOptionPageAttribute. Стрелка может быть пустой или она может содержать идентификатор ссылки на локализованную строку в вспомогательной библиотеки DLL реализации. Для реализаций на основе управляемых области пакета, это значение получено из аргументов pageNameResourceID в конструктор ProvideOptionPageAttribute. |
Страница |
REG_SZ |
GUID |
Идентификатор GUID объекта, реализующий пользовательскую страницу Сервис параметры. Реализации на основе управляемых области пакета с помощью ProvideOptionPageAttribute использующие аргумент pageType конструктора, содержащий Type и отражение VSPackage для получения этого значения. |
Пакет |
REG_SZ |
GUID |
Реализации на основе управляемых области пакета с помощью отражения использования ProvideOptionPageAttribute для получения этого значения. |
ResourcePackage |
REG_SZ |
GUID |
Необязательный. Вспомогательной библиотеки DLL, содержащей локализованные строки, если при реализации VSPackage не передает их. Управляемые границы пакета используют отражение для получения правильную библиотеку ресурсов, поэтому ProvideOptionPageAttribute не устанавливает этот аргумент. |
NoShowAllView |
REG_DWORD |
0 или 1 |
Необязательный. Указывает, должна ли заданный страница Сервис параметры отображаться в сложное (по умолчанию) представление страниц Сервис параметры. Поддерживает программные среды, например Visual Basic, которые имеют специальные страницы Сервис параметры для статистической обработки общих параметров для предоставления пользователям со специализированными упрощенными представлениями параметров. Если запись REG_DWORD безнулева, страница Сервис параметры не отображается в сложное представление. Дополнительные сведения см. в разделе Диалоговое окно "Параметры" (Visual Studio). Реализации на основе управляемых области пакета, могут установить это значение путем задания свойства NoShowAllView к true в конструкторе ProvideOptionPageAttribute. |
VSPackage или объект на основе одной сборке взаимодействия могут реализовывать более одной страницы Сервис параметры. Каждая реализация требует новой записи в HKLM\Software\Microsoft\VisualStudio\<Версия>\ToolsOptionsPages.
По мере того, как управляемые создает структуры пакета объект, предоставляющий страницу Сервис параметры каждая страница должны иметь свой собственный объект реализации, независимо от реализации VSPackage Package.
Поддержка автоматизации
Если поддержка автоматизации используется для реализации страницу Сервис параметры, она должна зарегистрировать как поставщик автоматизации. Для использования автоматизации для управления свойствами и использования его механизмов сохраняемости сохранение состояния веб-страницы Сервис параметры, он должен зарегистрировать как поставщик AutomationProperty.
Зарегистрируйте VSPackage как поставщик автоматизации (только для страниц Параметры средств на основе сборках взаимодействия)
Страницы Сервис параметры на основе сборке взаимодействия реализуются как часть классов реализации VSPackage.
В этом случае, если страница Сервис параметры поддержки автоматизации VSPackage сборка-основанное взаимодействия должен быть зарегистрирован как поставщик автоматизации.
Примечание
Поддержка автоматизации в управляемых области пакета обеспечивается независимым объекта реализации VSPackage.Если этот объект поддерживает автоматизацию, то это свойство SupportsAutomation зарегистрирован с помощью конструктора ProvideOptionPageAttribute.
Запись регистрации VSPackage как поставщик автоматизации формы HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия>\Packages\<PackageGUID>\Automation, где <Версия> — это версия Visual Studio (например 8.0) и <PackageGUID> — это GUID VSPackage реализующий объект автоматизации.
Примечание
Путь корневого раздела HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия> можно переопределить с корнем при инициализации оболочки Visual Studio.Дополнительные сведения см. в разделе Параметры командной строки (SDK для Visual Studio).
Структура записи реестра:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия>\Packages\<PackageGUID>\Automation
<AutomationObjectName>
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
Автоматизация |
REG_SZ |
Не указано |
Не определено. Присутствие данного ключа указывает, что VSPackage, на который указывает <PackageGUID>, поддерживает автоматизацию. Поля можно использовать для хранения документация. ProvideAutomationObjectAttribute автоматически создает эта клавиша для управляемых приложений, основанных на платформе пакета. |
<AutomationObjectName> |
REG_SZ |
Каноническое имя указанного объекта автоматизации |
Является значимым только имя ключа. Он используется в операциях автоматизации. Поля можно использовать для хранения документация. Для реализаций на основе управляемых области пакета, имя данной клавиши указано аргументом name в конструктор ProvideAutomationObjectAttribute. Если конструктор имеет допустимое строковое ProvideAutomationObjectAttribute передаваемое его свойству Description, то это значение будет вставлено здесь. |
Зарегистрируйте эту страницу параметров средств, таких как поддержка автоматических тестов
Управляемые среды и реализации пакетов и взаимодействия сборка-основанного страниц Сервис параметры необходимо зарегистрировать, чтобы разрешить доступ к странице Сервис параметры автоматизации. Это обеспечивает механизмы и к сохраняемости свойства автоматизации к странице через EnvDTE. Это независимый сам регистрации VSPackage как поставщик услуг автоматизации.
Например, при регистрации страницы Сервис параметры упомянутая выше запись имеет первичный ключ с категорией (<PageCategory>) страницы Сервис параметры и подраздел содержит имя подкатегории страницы (<PageSubcategory>).
При использовании управляемых границы пакета, используйте ProvideOptionPageAttribute для регистрации класса, как предоставление страницу Сервис параметры и задать свойство SupportsAutomationtrue, чтобы указать, что страница поддерживает автоматизацию.
Запись реестра находится в HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия>\AutomationProperties, где <Версия> — это версия Visual Studio, например 8.0.
Примечание
Путь корня HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия> можно переопределить с корнем оболочки Visual Studio при инициализации для получения дополнительных сведений см. Параметры командной строки (SDK для Visual Studio).
Структура записи реестра ниже:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия>\AutomationProperties
<PageCategory> = ‘#456’
ResourcePackage = «{}»
<PageSubCategory> = ‘#789’
Пакет = «{YYYYYY ГГГГ ГГГГ ГГГГ YYYYYYYYY}»
Имя = «<PageCategory> .<PageSubcategory>»
«ProfileSave» = 1/0
В следующей таблице перечислены значения в разделе HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия>\AutomationProperties\<PageCategory>.
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
(Значение по умолчанию) |
REG_SZ |
Каноническое имя категории пользовательской страницы Сервис параметры |
Имя клавиш, > <PageCategory, каноническое нелокализованное имя категории страницы Сервис параметры. Примечание Если автоматизация поддерживается, то канонические non-локализованные имена категорий и подкатегорий используются, чтобы получить коллекцию Properties страницы Сервис параметры.Дополнительные сведения см. в разделе С помощью страницы параметров. Стрелка может быть пустой или она может содержать идентификатор ссылки на локализованную строку в реализации вспомогательной библиотеки DLL. Для реализаций на основе управляемых области пакета, > <PageCategory получено из аргументов categoryName в конструктор ProvideOptionPageAttribute. |
ResourcePackage |
REG_SZ |
GUID |
Необязательный. Вспомогательной библиотеки DLL, содержащей локализованные строки, если при реализации VSPackage не передает их. Управляемые границы пакета используют отражение для получения правильного ресурс VSPackage, поэтому ProvideOptionPageAttribute не устанавливает этот аргумент. |
В следующей таблице перечислены значения в разделе HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Версия>\AutomationProperties\<PageCategory>\<PageSubCategory>.
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
(Значение по умолчанию) |
REG_SZ |
Имя подкатегории пользовательской страницы Сервис параметры |
Имя клавиш, > <PageSubCategory, каноническое нелокализованное имя подкатегории страницы Сервис параметры. Примечание Если автоматизация поддерживается, то канонические non-локализованные имена категорий и подкатегорий используются, чтобы получить коллекцию Properties страницы Сервис параметры.Дополнительные сведения см. в разделе С помощью страницы параметров. Стрелка может быть пустой или она может содержать идентификатор ссылки на локализованную строку в реализации вспомогательной библиотеки DLL. Для реализаций на основе управляемых области пакета, <PageSubCategory> получено из аргументов pageName в конструктор ProvideOptionPageAttribute. |
Пакет |
REG_SZ |
GUID |
Идентификатор GUID VSPackage, реализующий пользовательскую страницу Сервис параметры. Реализации на основе управляемых области пакета с помощью отражения использования ProvideOptionPageAttribute для получения этого значения. |
Имя |
REG_SZ |
Имя коллекции свойств страницы Сервис параметры |
Строка <PageCategory>.<PageSubCategory>, используемая для обращения к странице Сервис параметры. Дополнительные сведения см. в разделе С помощью страницы параметров. Для реализаций на основе управляемых области пакета, имя получено из аргументов конструктора ProvideOptionPageAttribute и формы categoryName.pageName. |
ProfileSave |
DWORD |
1/0 |
Необязательный. Это значение указывает, сохраняются ли настройки страницы параметров Сервис параметры механизмом Visual Studio, когда пользователь выбирает соответствующую команду Параметры импорта-экспорта в меню Сервис. Если клавиша присутствует, а его значение равно 1, то страница Сервис параметры запрашивает поддержку параметров. Реализации на основе управляемых области пакета устанавливают это значение, если предоставляют конструктор ProvideOptionPageAttribute со свойством SupportsProfiles к true. |
См. также
Задачи
Практическое руководство. Создание пользовательских страниц параметров
Ссылки
Основные понятия
Создание страницы параметров с помощью сборок взаимодействия
Поддержка автоматизации для страницы параметров