InstalledProductRegistrationAttribute Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Этот атрибут регистрирует установленный продукт для пакета.
Это позволяет пакету представлять сведения на экране-заставки VS или справке о программе.
public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute
public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute
[System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)]
public sealed class InstalledProductRegistrationAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute
[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)>]
type InstalledProductRegistrationAttribute = class
inherit RegistrationAttribute
Public NotInheritable Class InstalledProductRegistrationAttribute
Inherits RegistrationAttribute
- Наследование
- Атрибуты
Комментарии
Когда следует звонить
Примените этот атрибут к классу VSPackage, чтобы предоставить сведения, отображаемые на экране-заставке Visual Studio и в диалоговом окне Справка о программе .
Основное использование
InstalledProductRegistrationAttribute
Create объект для регистрации VSPackage в диалоговом окне Справочные сведения. Различные конструкторы предоставляют варианты использования IVsInstalledProduct интерфейса (реализованного пакетом) для сбора сведений и их отображения на экране-заставки Visual Studio. Чтобы использовать этот атрибут, поместите его в класс VSPackage (класс, производный от Package или класс, реализующий IVsPackage).
Этот атрибут используется только для предоставления данных для внешних средств регистрации, таких как regpkg.exe. Он не влияет на поведение vsPackage в среде выполнения. Дополнительные сведения см. в разделе Регистрация VSPackage.
Примечание
Visual C# автоматически добавляет слово Attribute к имени любого класса атрибута. В коде Visual C# указать этот атрибут как InstalledProductRegistration.
Записи реестра
Следующие записи реестра создаются :InstalledProductRegistrationAttribute
<VSROOT>\CLSID\{PackageGuid}
<VSROOT>\CLSID\{PackageGuid}\@=ObjectType.FullName
<VSROOT>\CLSID\{PackageGuid}\InprocServer32=mscoree.dll
<VSROOT>\CLSID\{PackageGuid}\Class=ObjectType.FullName
<VSROOT>\CLSID\{PackageGuid}\Assembly=ObjectType.Assembly.FullName
<VSROOT>\CLSID\{PackageGuid}\ThreadingModel=Both
<VSROOT>\CLSID\{PackageGuid}\CodeBase=context. Codebase
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\Path=SatelliteDllPath
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\DllName=SatelliteDllName
Примеры
Стандартное расположение для этого и всех остальных атрибутов, используемых для автоматической регистрации, находится рядом с реализацией Package в VsPkg.cs, VsPkg.vb или VsPkg.cpp в зависимости от языка, используемого в примере.
Конструкторы
InstalledProductRegistrationAttribute(String, String, String) |
Создает атрибут InstalledProductRegistrationAttribute для регистрации пакета в диалоговом окне "Справка/О программе". Это самая простая информация о регистрации, необходимая для сторонних пакетов. Предоставление сведений о продукте не является обязательным, но рекомендуется. |
Свойства
IconResourceID |
Идентификатор ресурса значка. |
LanguageIndependentName |
Имя продукта. |
ProductDetails |
Подробное описание продукта. |
ProductDetailsResourceID |
Идентификатор ресурса для сведений. |
ProductId |
Идентификатор продукта. |
ProductName |
Имя продукта. |
ProductNameResourceID |
Идентификатор ресурса, соответствующий названию продукта. |
TypeId |
Переопределите свойство TypeID, чтобы разрешить производным классам RegistrationAttribute работать с System.ComponentModel.TypeDescriptor.GetAttributes(...). Атрибут, производный от этого , должен переопределять это свойство только в том случае, если ему требуется более качественный контроль над экземплярами, которые можно применить к классу. (Унаследовано от RegistrationAttribute) |
UseInterface |
Используйте IVsInstalledProduct для заполнения диалогового окна Справки о программе. Пакет должен реализовывать IVsInstalledProduct. |
UsePackage |
True — установка продукта будет использовать идентификатор пакета. |
UseVsProductId |
Значение True— идентификатор продукта совпадает с идентификатором VisualStudio. Этот код зарезервирован для внутреннего использования Майкрософт. Сторонние пакеты должны предоставлять собственный идентификатор продукта при создании класса. |
Методы
GetPackageRegKeyPath(Guid) |
Получает путь в реестре (относительно корня реестра приложения) VSPackage. (Унаследовано от RegistrationAttribute) |
Register(RegistrationAttribute+RegistrationContext) |
Вызывается для регистрации атрибута с данным контекстом. |
Unregister(RegistrationAttribute+RegistrationContext) |
Отмените регистрацию этой записи InstalledProducts. |