InstalledProductRegistrationAttribute 类

定义

命名空间:

Microsoft.VisualStudio.Shell

程序集:

Microsoft.VisualStudio.Shell.15.0.dll

包:

Microsoft.VisualStudio.Shell.15.0 v17.11.40262

此属性为包注册“已安装产品”。
这使你的包能够在 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

继承

Attribute

RegistrationAttribute

InstalledProductRegistrationAttribute

属性

AttributeUsageAttribute

注解

何时调用

将此属性应用于 VSPackage 类，以提供在 Visual Studio 初始屏幕和 “关于帮助 ”对话框中显示的信息。

基本用法

Create一个 InstalledProductRegistrationAttribute 对象，将 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

示例

此属性和用于自动注册的所有其他属性的标准位置与 VsPkg.cs、VsPkg.vb 或 VsPkg.cpp 中的 实现 Package 相邻，具体取决于示例中使用的语言。

构造函数

InstalledProductRegistrationAttribute(String, String, String)

创建新的 InstalledProductRegistrationAttribute 以将包注册到“帮助/关于”对话框。 这是第三方包所需的最简单的注册信息。 提供产品详细信息不是一项要求，但建议提供。

属性

IconResourceID	图标的资源 ID。
LanguageIndependentName	产品的名称。
ProductDetails	产品的详细说明。
ProductDetailsResourceID	详细信息的资源 ID。
ProductId	产品 ID。
ProductName	产品的名称。
ProductNameResourceID	对应于产品名称的资源 ID。
TypeId	重写 TypeID 属性，使 RegistrationAttribute 派生类能够与 System.ComponentModel.TypeDescriptor.GetAttributes 一起使用 (...) 。仅当派生自此属性的属性需要对可应用于类的实例使用更好的控件时，它才必须重写此属性。 (继承自 RegistrationAttribute)
UseInterface	使用 IVsInstalledProduct 填写“有关帮助”对话框。 包必须实现 IVsInstalledProduct。
UsePackage	True 是产品安装将使用包 ID
UseVsProductId	如果产品 ID 与 VisualStudio ID 相同，则为 True 这是为 Microsoft 内部保留的。 构造类时，第三方包应提供其自己的产品 ID。

方法

GetPackageRegKeyPath(Guid)	获取相对于 VSPackage 的应用程序) 注册表根目录 (注册表路径。 (继承自 RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	调用以便向给定的上下文注册此属性。
Unregister(RegistrationAttribute+RegistrationContext)	取消注册此 InstalledProducts 条目。