InstalledProductRegistrationAttribute Třída

Definice

Obor názvů:

Microsoft.VisualStudio.Shell

Sestavení:

Microsoft.VisualStudio.Shell.15.0.dll

Balíček:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Tento atribut zaregistruje nainstalovaný produkt pro váš balíček.
Díky tomu může balíček prezentovat informace na úvodní obrazovce sady VS nebo v nápovědě k produktu.

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

Dědičnost

Attribute

RegistrationAttribute

InstalledProductRegistrationAttribute

Atributy

AttributeUsageAttribute

Poznámky

Kdy volat

Pomocí tohoto atributu na třídu VSPackage zadejte informace, které se zobrazí na úvodní obrazovce sady Visual Studio a v dialogovém okně Nápověda k aplikaci.

Základní využití

Create objekt pro InstalledProductRegistrationAttribute registraci balíčku VSPackage v dialogovém okně Nápověda k aplikaci. Různé konstruktory poskytují možnosti použití IVsInstalledProduct rozhraní (implementovaného balíčkem) ke shromáždění informací a jejich zobrazení na úvodní obrazovce sady Visual Studio. Pokud chcete použít tento atribut, umístěte ho do třídy VSPackage (třídy odvozené z Package nebo třídy, která implementuje IVsPackage).

Tento atribut slouží pouze k poskytování dat pro externí registrační nástroje, jako je regpkg.exe. Nemá žádný vliv na chování modulu runtime sady VSPackage. Další informace najdete v tématu Registrace balíčku VSPackage.

Poznámka

Visual C# automaticky připojí slovo Atribut k názvu libovolné třídy atributu. V kódu jazyka Visual C# tento atribut označte jako InstalledProductRegistration.

Položky registru

Následující položky registru jsou vytvořeny uživatelem 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

Ukázky

Standardní umístění tohoto a všech ostatních atributů používaných pro automatickou registraci je v závislosti na jazyce použitém v ukázce vedle implementace Package v VsPkg.cs, VsPkg.vb nebo VsPkg.cpp.

Konstruktory

InstalledProductRegistrationAttribute(String, String, String)

Vytvoří nový Atribut InstalledProductRegistrationAttribute pro registraci balíčku v dialogovém okně Nápověda/Informace. Jedná se o nejjednodušší registrační informace potřebné pro balíčky třetích stran. Poskytnutí podrobností o produktu není povinné, ale doporučuje se.

Vlastnosti

IconResourceID	ID prostředku ikony.
LanguageIndependentName	Název vašeho produktu.
ProductDetails	Podrobný popis produktu.
ProductDetailsResourceID	ID prostředku pro podrobnosti.
ProductId	Vaše ID produktu.
ProductName	Název vašeho produktu.
ProductNameResourceID	ID prostředku odpovídající názvu produktu.
TypeId	Přepište vlastnost TypeID, aby mohly odvozené třídy RegistrationAttribute pracovat s System.ComponentModel.TypeDescriptor.GetAttributes(...). Atribut odvozený z tohoto bude muset přepsat tuto vlastnost pouze v případě, že potřebuje lepší kontrolu nad instancemi, které lze použít na třídu. (Zděděno od RegistrationAttribute)
UseInterface	Pomocí funkce IVsInstalledProduct vyplňte dialogové okno Nápověda k tématu. Balíček musí implementovat IVsInstalledProduct.
UsePackage	Je pravda, že instalace produktu použije ID balíčku.
UseVsProductId	Pravda je, že ID produktu je stejné jako ID VisualStudio Toto je vyhrazeno pro interní použití Microsoftu. Balíčky třetích stran by měly při vytváření třídy poskytovat vlastní ID produktu.

Metody

GetPackageRegKeyPath(Guid)	Získá cestu registru (vzhledem k kořenovému adresáři registru aplikace) VSPackage. (Zděděno od RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Volá se pro registraci tohoto atributu v daném kontextu.
Unregister(RegistrationAttribute+RegistrationContext)	Zrušte registraci této položky InstalledProducts.