Регистрация функции поддержки панели элементов
VSPackages должно обновить реестр, если они расширяют набор по умолчанию Панель элементов функциональность одним из следующих способов:
Автоматическое выделение с помощью вкладки области элементов, определенных категорий или вкладки панели элементов, когда конструктор или редактор, определенные активные.
Защита любых ToolboxItem объекты для загрузки Visual Studio среда.
Эти элементы будут загружаться Visual Studio когда среда Панель элементов сбросить или пользователем с помощью интегрированной среды разработки или программно посредством ResetDefaults метод. Сбросить Панель элементов создает a ToolboxInitialized события в управляемых пакетом .NET Framework.
Примечание
VSPackages превратилось в управляемых использованием .NET Framework пакета ProvideToolboxItemsAttribute при применении к их реализации Package объект, чтобы зарегистрировать эти средства.
Защита нестандартный формат буфера обмена ToolboxItem объекты, реализовав IVsToolboxDataProvider и IVsToolboxDataProvider2 интерфейсы.
Примечание
VSPackages, начиная с использованием .NET Framework пакета управляемый экземпляр ProvideToolboxFormatAttribute объект, примененный к их реализации Package зарегистрировать эти средства.
Поддержка динамическая конфигурация ToolboxItem объект посредством реализации IConfigureToolboxItem интерфейс.
Примечание
VSPackages превратилось с управляемыми использованием .NET Framework пакета ProvideToolboxItemConfigurationAttribute при применении к их реализации Package класс. ProvideAssemblyFilterAttribute класс, примененный к их реализаций IConfigureToolboxItem класс, чтобы зарегистрировать эти средства.
Автономное VSPackages должно явным образом обновить реестр или изменить его вручную или с помощью файла регистраторшы (.rgs). Дополнительные сведения см. в разделе Создать скрипты регистратора.
Автоматическое выделение вкладки панели элементов
Редакторы и конструкторы, при условии, что экземпляром объекта фабрики редактора, могут требовать указанной вкладки или категорий области элементов, которое необходимо активировать, когда они сами активна. Например, если конструктор форм активирован, может понадобиться Все формы Windows Forms выбранная вкладка.
Для автоматического выбора категории области элементов, которые необходимо помнить, что конструктор или объект фабрики редактора должен быть правильно зарегистрирован.
Соответствующую запись реестра находится в следующем расположении реестра: HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ Редактор<Идентификатор GUID фабрики редактора>, где <Версия> номер версии выпуска Visual Studio, например 8,0, и <Идентификатор GUID фабрики редактора> идентификатор GUID фабрики редактора.
Запись должна включать:
Имя |
Тип |
Диапазон |
Описание |
|---|---|---|---|
Default |
REG_SZ |
GUID |
Необязательный. Его можно использовать для хранения нелокализованное имя редактора. |
DefaultToolboxTab |
REG_SZ |
"Имя вкладки здесь" |
Нелокализованное имя вкладки области элементов, которая производится по умолчанию вкладке области элементов, если этот редактор активен. |
Примечание
Нет Attribute объекты, поддерживающие эти записи реестра в управляемом пакете .NET Framework.
Регистрация пакет как защита элементов панели инструментов
Примечание
Элементы управления, созданные с помощью шаблонов элементов управления панели элементов в пакет SDK Visual Studio 10 регистрируют автоматически.Дополнительные сведения см. в разделах Практическое руководство. Создание элемента управления панели элементов является использования Windows Forms и Практическое руководство. Создание элемента управления панели элементов является использования WPF.
Любой защита VSPackage T: System.Drawing.Design.ToolboxItem объекты должны иметь подраздел Панель элементовпод собственным ключом пакета, HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ Packages \<Идентификатор GUID пакета>, где <Версия> номер версии выпуска Visual Studio, например 8,0, и <Идентификатор GUID пакета> идентификатор GUID пакета, предоставляющего Панель элементов элементы.
Этот подраздел панели элементов должен содержать по крайней мере одну запись с именем записи DWORD По умолчаниюЭлементы.
Примечание
Путь корня HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия> может быть переопределен с корнем при инициализации или оболочки Visual Studio можно использовать DefaultRegistryRootAttribute.Дополнительные сведения см. в разделе Параметры командной строки (SDK для Visual Studio).
Для записи в разделе HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ Packages \<Идентификатор GUID пакета>:
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
Элементы по умолчанию |
REG_DWORD |
Может принимать любое значение DWORD. Начинается с 1. Значение увеличивается при обновлении в VSPackage для предоставления более или другие элементы. |
Значение Элементы по умолчанию должен быть больше или равен 1, добавляемый ToolboxItem объекты Visual Studio Панель элементов. Изменение значения Элементы по умолчанию вызывает Visual Studio Интегрированная среда разработки, чтобы загрузить последний экземпляр защита VSPackage ToolboxItem объекты, а не с помощью все кэшированные значения. В управляемом пакете .NET Framework Элементы по умолчанию набор значением, используемым в конструкторе, ProvideToolboxItemsAttribute экземпляр, примененный к предоставлению VSPackage ToolboxItem объекты. |
Регистрация поддержка нештатного формата
Регистрация поддерживаемых форматов буфера обмена, a ToolboxItem поставщик VSPackage поддерживает необязательный.
Если набор узлов a ToolboxItem VSPackage не регистрирует поставщик специальных форматов буфера обмена, он должен поддерживать Visual Studio стандартные форматы. Дополнительные сведения о стандарте Панель элементов Формат буфера обмена, см. в разделе Панель элементов (Visual Studio).
Если VSPackage предоставляет поддержку для нестандартных форматов, он должен зарегистрировать эти форматы в VSPackage Панель элементов регистрация ключевое HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ Packages \<Идентификатор GUID пакета> \ панель элементов, добавить запись строки Форматы.
Примечание
Если VSPackage регистрирует поддержка для любого пользовательского формата, то он поддерживает только те форматы, которые явным образом регистрирует.VSPackage при регистрации пользовательских форматов буфера обмена больше не зарегистрирована как сохранять значение по умолчанию Панель элементов Формат буфера обмена, если она не будет сделать поэтому явно.
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
Форматы |
REG_SZ |
Для пользовательских форматов, используйте строку для данного подраздела. |
Определяет формат буфера обмена, поддерживаемые VSPackage, предоставляющий пользовательскую Панель элементов Формат буфера обмена (путем реализации IVsToolboxDataProvider и IVsToolboxDataProvider2). Форматы должны быть указаны в списке с разделителями-запятыми. Формат может быть задана с измененной строкой или его имени или по имени идентификатора. Например, a Formats запись может оказаться '1,13,16,HTML Format'. Дополнительные сведения о форматах буфера обмена см. в разделе Format. в управляемом пакете .NET Framework, значение Форматы возвращает из строки, используемой в качестве аргумента конструктору экземпляра ProvideToolboxFormatAttribute объект, примененный к предоставлению VSPackage ToolboxItem объекты. |
Регистрация поддержка динамической конфигурации элемента панели инструментов
Обеспечивает реализацию если VSPackage IConfigureToolboxItem он должен добавлять параметры реестра в разделе HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ CLSID. и HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ ToolboxItemConfiguration.
Данные реестра в разделе HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ CLSID содержит сведения Visual Studio среды требуется для вызова реализация IConfigureToolboxItem.
HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ ToolboxItemConfiguration данные используются для их выборки или фильтрации, ToolboxItem объекты реализация IConfigureToolboxItem настраивает на основе сборок, содержащих их.
Содержимое HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ CLSID запись реестра:
Примечание
В управляемых пакетом .NET Framework, эти записи реестра были созданы экземпляром ProvideToolboxItemConfigurationAttribute.Этот экземпляр вложен в VSPackage, предоставляющий ToolboxItem конфигурация с помощью отражения.Отражение выполняется на IConfigureToolboxItem элемент, который реализуется ProvideToolboxItemConfigurationAttribute конструктор.
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
(Значение по умолчанию) |
REG_SZ |
(Необязательный параметр) Полное имя реализации класса IConfigureToolboxItem. |
Здесь значение должно быть таким же, как предоставленный by FullName для функционирования Type реализация IConfigureToolboxItem. |
Сборка |
REG_SZ |
Полное имя сборки, предоставляя IConfigureToolboxItem |
Это значение должно быть полным идентификацией сборки, в зависимости от сборки, может включать:
Значение должно быть списком значений с разделителями-запятыми свойства, например, следующими способами FullName свойство, действующий на Type реализация IConfigureToolboxItem. Например: Знаки подстановки не поддерживаются. Дополнительные сведения о формате полных имен сборок см. в разделе AssemblyQualifiedName. Дополнительные сведения об идентификации сборки см. в разделе AssemblyName. |
Класс |
REG_SZ |
Полное имя реализации класса IConfigureToolboxItem интерфейс изменений by FullName. |
Значение должно быть такой же, как у предоставленного by FullName, действующ о реализации типа IConfigureToolboxItem. |
CodeBase |
REG_SZ |
Реализация указав местоположение сборки IConfigureToolboxItem |
Это значение должно представлять собой полный путь к файлу сборки, содержащей реализацию IConfigureToolboxItem. |
Внутренний 32-разрядный сервер |
REG_SZ |
Должны всегда имеет значение "C:\WINDOWS\System32\mscoree.dll" |
В процессе сервера |
ThreadingModel |
REG_SZ |
Должны всегда имеет значение "Both" |
Потоковая модель |
Содержимое HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ ToolboxItemConfiguration запись реестра:
Примечание
В управляемых пакетом .NET Framework, эти записи реестра были созданы экземпляром ProvideAssemblyFilterAttribute вложенно к Type предоставление реализации IConfigureToolboxItem.
Имя |
Тип |
Данные |
Описание |
|---|---|---|---|
AssemblyName |
REG_SZ |
Спецификация сборок для выбора или фильтрации. |
Имя ключа AssemblyName, должно быть задано в формате полного идентификации сборки, в зависимости от сборок для фильтрации, может включать:
Имя ключа должно быть списком с разделителями-запятыми пар свойство-значение. Дополнительные сведения о формате полных имен сборок см. в разделе Type.FullName свойство. Подстановочный знак "*" поддерживает в этом значении, а любое не предоставленное поле рассматривается как подстановочный символ. На пример, ключевое имя выбирает все сборки с пространствами имен вниз System.Windows (но не System.Windows сам), для всех последующих номеров версии выпуска 8,0, а для всех языков и региональных параметров, значения ключей шифрования и пользовательских строк. В управляемом пакете .NET Framework <Имя сборки> имя ключа указывается строкой, используемой в качестве аргумента в конструктор ProvideAssemblyFilterAttribute экземпляр применяется к реализации класса IConfigureToolboxItem интерфейс. |
<ImplementationObject> |
REG_SZ |
GUID |
Имя данного подраздела AssemblyName полное имя Type реализация IConfigureToolboxItem интерфейс. Значение этого подраздела GUID данного Type. В управляемом пакете .NET Framework это сведения извлекаются через отражение от реализации класса IConfigureToolboxItem интерфейс with a ProvideAssemblyFilterAttribute объект, примененный к нему. |
Пример записи в разделе HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ ToolboxItemConfiguration будет следующий раздел:
Vsip.*, Version=2.0.3500
Vsip.ToolboxConfiguration = {YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY}
См. также
Ссылки
ProvideAssemblyFilterAttribute