Udostępnij za pośrednictwem


InstalledProductRegistrationAttribute Klasa

Definicja

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
InstalledProductRegistrationAttribute
Atrybuty

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.

Dotyczy