InstalledProductRegistrationAttribute Klasa

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Shell

Zestaw:

Microsoft.VisualStudio.Shell.15.0.dll

Pakiet:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Ten atrybut rejestruje "zainstalowany produkt" dla pakietu.
Dzięki temu pakiet może prezentować informacje na ekranie powitalnym programu VS lub w Pomocy dotyczącej.

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

Dziedziczenie

Attribute

RegistrationAttribute

InstalledProductRegistrationAttribute

Atrybuty

AttributeUsageAttribute

Uwagi

Kiedy zadzwonić

Zastosuj ten atrybut do klasy VSPackage, aby podać informacje wyświetlane na ekranie powitalnym programu Visual Studio i w oknie dialogowym Informacje o pomocy .

Podstawowe użycie

Twórca obiekt, InstalledProductRegistrationAttribute aby zarejestrować pakiet VSPackage w oknie dialogowym Informacje o pomocy. Różne konstruktory udostępniają opcje używania interfejsu IVsInstalledProduct (zaimplementowanego przez pakiet) w celu zebrania informacji i wyświetlenia ich na ekranie powitalnym programu Visual Studio. Aby użyć tego atrybutu, umieść go w klasie VSPackage (klasie pochodnej Package lub takiej, która implementuje IVsPackage).

Ten atrybut jest używany tylko do dostarczania danych dla zewnętrznych narzędzi rejestracji, takich jak regpkg.exe. Nie ma żadnego wpływu na zachowanie środowiska uruchomieniowego pakietu VSPackage. Aby uzyskać więcej informacji, zobacz Rejestracja pakietu VSPackage.

Uwaga

Visual C# automatycznie dołącza wyraz Atrybut do nazwy dowolnej klasy atrybutu. W kodzie Visual C# należy odwołać się do tego atrybutu jako InstalledProductRegistration.

Wpisy rejestru

Następujące wpisy rejestru są tworzone przez program 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

Przykłady

Standardowa lokalizacja dla tego i wszystkich innych atrybutów używanych do automatycznej rejestracji jest sąsiadująca z implementacją Package elementu w VsPkg.cs, VsPkg.vb lub VsPkg.cpp, w zależności od języka używanego w przykładzie.

Konstruktory

InstalledProductRegistrationAttribute(String, String, String)

Tworzy nowy atrybut InstalledProductRegistrationAttribute, aby zarejestrować pakiet w oknie dialogowym Pomoc/Informacje. Są to najprostsze informacje rejestracyjne niezbędne dla pakietów innych firm. Podanie szczegółów produktu nie jest wymagane, ale jest zalecane.

Właściwości

IconResourceID	Identyfikator zasobu ikony.
LanguageIndependentName	Nazwa produktu.
ProductDetails	Szczegółowy opis produktu.
ProductDetailsResourceID	Identyfikator zasobu dla szczegółów.
ProductId	Identyfikator produktu.
ProductName	Nazwa produktu.
ProductNameResourceID	Identyfikator zasobu odpowiadający nazwie produktu.
TypeId	Zastąp właściwość TypeID, aby umożliwić klasom pochodnym RegistrationAttribute pracować z atrybutem System.ComponentModel.TypeDescriptor.GetAttributes(...). Atrybut pochodzący z tego atrybutu będzie musiał zastąpić tę właściwość tylko wtedy, gdy potrzebuje lepszej kontroli nad wystąpieniami, które można zastosować do klasy. (Odziedziczone po RegistrationAttribute)
UseInterface	Użyj funkcji IVsInstalledProduct, aby wypełnić okno dialogowe Pomoc dotyczącą. Pakiet musi implementować IVsInstalledProduct.
UsePackage	Prawda: instalacja produktu będzie używać identyfikatora pakietu
UseVsProductId	Prawda, czy identyfikator produktu jest taki sam jak identyfikator programu VisualStudio. Jest to zarezerwowane do użytku wewnętrznego firmy Microsoft. Pakiety innych firm powinny podać swój własny identyfikator produktu podczas konstruowania klasy.

Metody

GetPackageRegKeyPath(Guid)	Pobiera ścieżkę rejestru (względem katalogu głównego rejestru aplikacji) pakietu VSPackage. (Odziedziczone po RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Wywoływana w celu zarejestrowania tego atrybutu w danym kontekście.
Unregister(RegistrationAttribute+RegistrationContext)	Wyrejestruj ten wpis InstalledProducts.