InstalledProductRegistrationAttribute 類別

定義

命名空間:

Microsoft.VisualStudio.Shell

組件:

Microsoft.VisualStudio.Shell.15.0.dll

套件:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

此屬性會為您的套件註冊「已安裝的產品」。
這可讓您的套件在 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 啟動顯示畫面和 [ 說明相關信息 ] 對話框的資訊。

基本使用方式

InstalledProductRegistrationAttributeCreate 物件，向 [說明關於] 對話框註冊 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	圖示的資源標識碼。
LanguageIndependentName	您產品的名稱。
ProductDetails	產品的詳細描述。
ProductDetailsResourceID	詳細數據的資源識別碼。
ProductId	您的產品識別碼。
ProductName	您產品的名稱。
ProductNameResourceID	對應至產品名稱的資源識別碼。
TypeId	覆寫 TypeID 屬性，讓 RegistrationAttribute 衍生類別搭配 System.ComponentModel.TypeDescriptor.GetAttributes (...) 。衍生自這個屬性的屬性只有在需要對可套用至類別的實例有更好的控制權時，才必須覆寫此屬性。 (繼承來源 RegistrationAttribute)
UseInterface	使用 IVsInstalledProduct 填入 [說明] 對話框。 套件必須實作 IVsInstalledProduct。
UsePackage	True 是產品安裝將使用套件識別碼
UseVsProductId	True 是表示 產品標識碼與 VisualStudio 識別符相同。這是保留供 Microsoft 內部使用。 建構 類別時，第三方套件應該提供自己的產品標識符。

方法

GetPackageRegKeyPath(Guid)	取得相對於 VSPackage 之應用程式) 之登錄根目錄的登錄路徑 (。 (繼承來源 RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	呼叫以註冊這個具有指定內容的屬性。
Unregister(RegistrationAttribute+RegistrationContext)	取消註冊此 InstalledProducts 專案。