InstalledProductRegistrationAttribute Klasse

Definition

Stellt Informationen für den Visual Studio-Begrüßungsbildschirm und das Dialogfeld Hilfe zu bereit, wenn diese auf eine von Package abgeleitete Klasse oder eine Klasse angewendet werden, die implementiert IVsPackage . Diese Klasse kann nicht vererbt werden.

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
Vererbung
InstalledProductRegistrationAttribute
Attribute

Hinweise

Wann soll aufgerufen werden?

Wenden Sie dieses Attribut auf die VSPackage-Klasse an, um Informationen bereitzustellen, die auf dem Begrüßungs Visual Studio Bildschirm und im Dialogfeld Hilfe zu angezeigt werden.

Grundlegende Verwendung

Erstellen Sie ein- InstalledProductRegistrationAttribute Objekt, um das VSPackage mit dem Dialogfeld Hilfe zu zu registrieren. Die verschiedenen Konstruktoren stellen die Optionen bereit, mit denen IVsInstalledProduct Sie die-Schnittstelle (wie vom Paket implementiert) verwenden können, um die Informationen zu erfassen und auf dem Begrüßungs Visual Studio Bildschirm anzuzeigen. Um dieses Attribut zu verwenden, platzieren Sie es in der VSPackage-Klasse (eine von abgeleitete Klasse oder eine Klasse Package , die implementiert IVsPackage ).

Dieses Attribut wird nur zur Bereitstellung von Daten für externe Registrierungs Tools wie regpkg.exe verwendet. Es wirkt sich nicht auf das Laufzeitverhalten des VSPackages aus. Weitere Informationen finden Sie unter VSPackage-Registrierung.

Hinweis

Visual C# Fügt das Word- Attribut automatisch an den Namen jeder Attribut Klasse an. Visual C#Verweisen Sie im Code auf dieses Attribut als InstalledProductRegistration.

Registrierungseinträge

Die folgenden Registrierungseinträge werden von erstellt 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 = beides

  • <VSROOT>\CLSID \ {packageguid} \codebase = Context. Codebasis

  • <VSROOT>\CLSID \ {packageguid} \satellitedll

  • <VSROOT>\CLSID \ {packageguid} \satellitedll\path = SatelliteDllPath

  • <VSROOT>\CLSID \ {packageguid} \satellitedll\dllname = SatelliteDllName

Proben

Der Standard Speicherort für dieses und alle anderen Attribute, die für die automatische Registrierung verwendet werden, hängen von der Implementierung von Package in vspkg.cs, vspkg. vb oder vspkg. cpp ab, abhängig von der Sprache, die im Beispiel verwendet wird.

Konstruktoren

InstalledProductRegistrationAttribute(String, String, String)

Initialisiert eine neue Instanz von InstalledProductRegistrationAttribute mit den angegebenen Produktinformationen.

Eigenschaften

IconResourceID

Ruft die Ressourcen-ID des Symbols ab, das dem Produkt zugeordnet ist, oder legt diese fest.

LanguageIndependentName

Ruft den (nicht lokalisierten) Namen des Produkts ab oder legt ihn fest.

ProductDetails

Ruft die ausführliche Beschreibung des Produkts ab oder legt Sie fest.

ProductDetailsResourceID

Ruft die Produktdetails-Ressourcen-ID ab oder legt Sie fest.

ProductId

Ruft die Produkt-ID ab oder legt Sie fest.

ProductName

Ruft den Namen des Produkts ab oder legt ihn fest.

ProductNameResourceID

Ruft die Ressourcen-ID des Produkt namens ab oder legt Sie fest.

TypeId

Ruft die aktuelle Instanz dieses Attributs ab.

(Geerbt von RegistrationAttribute)
UseInterface

Ruft ab oder ob das Paket die IVsInstalledProduct -Schnittstelle implementiert, um eine Bitmap auf dem Begrüßungsbildschirm anzuzeigen, sowie Informationen im Dialogfeld Info im Menü Hilfe.

UsePackage

Ruft ab oder legt fest, ob die Produktinstallation die Paket-ID verwendet

UseVsProductId

Bestimmt, ob die Produkt-ID mit der Visual Studio-ID identisch ist.

Methoden

GetPackageRegKeyPath(Guid)

Ruft den Registrierungspfad (relativ zum Registrierungsstamm der Anwendung) des VSPackages ab.

(Geerbt von RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)

Registriert Informationen zu einem VSPackage, wenn es von einem externen Registrierungs Tool wie regpkg.exe aufgerufen wird.

Unregister(RegistrationAttribute+RegistrationContext)

Entfernt die Registrierungsinformationen zu einem VSPackage, wenn der Aufruf über ein externes Registrierungstool wie regpkg.exe erfolgt.

Gilt für