InstalledProductRegistrationAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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. |