InstalledProductRegistrationAttribute Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- Atributy
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. |