InstalledProductRegistrationAttribute Klasse

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Shell

Assembly:: Microsoft.VisualStudio.Shell.14.0.dll

Assembly:: Microsoft.VisualStudio.Shell.15.0.dll

Paket:: Microsoft.VisualStudio.Shell.15.0 v17.12.40392

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.

Dieses Attribut registriert ein "installiertes Produkt" für Ihr Paket.
Dadurch kann Ihr Paket Informationen auf dem VS-Begrüßungsbildschirm oder hilfe info anzeigen.

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

RegistrationAttribute
InstalledProductRegistrationAttribute

Attribute: AttributeUsageAttribute

Hinweise

Wann sollte ich anrufen?

Wenden Sie dieses Attribut auf Ihre VSPackage-Klasse an, um Informationen bereitzustellen, die auf dem Begrüßungsbildschirm von Visual Studio und im Dialogfeld Hilfe info angezeigt werden.

Grundlegende Verwendung

Create ein InstalledProductRegistrationAttribute Objekt, um Ihr VSPackage mit dem Dialogfeld Hilfe info zu registrieren. Die verschiedenen Konstruktoren bieten die Optionen zum Verwenden der IVsInstalledProduct Schnittstelle (wie vom Paket implementiert), um die Informationen zu sammeln und auf dem Begrüßungsbildschirm von Visual Studio anzuzeigen. Um dieses Attribut zu verwenden, platzieren Sie es in Ihrer VSPackage-Klasse (eine Klasse, die von oder eine klasse abgeleitet wird Package , die implementiert IVsPackagewird).

Dieses Attribut wird nur verwendet, um Daten für externe Registrierungstools wie regpkg.exe bereitzustellen. Es hat keine Auswirkungen auf das Laufzeitverhalten des VSPackage. Weitere Informationen finden Sie unter VSPackage-Registrierung.

Hinweis

Visual C# fügt das Wort Attribut automatisch an den Namen einer beliebigen Attributklasse an. Verweisen Sie in Visual C#-Code auf dieses Attribut als InstalledProductRegistration.

Registrierungseinträge

Die folgenden Registrierungseinträge werden von InstalledProductRegistrationAttributeerstellt:

<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. Codebasis
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\Path=SatelliteDllPath
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\DllName=SatelliteDllName

Beispiele

Der Standardspeicherort für diese und alle anderen Attribute, die Package für die automatische Registrierung verwendet werden, befindet sich neben der Implementierung von in VsPkg.cs, VsPkg.vb oder VsPkg.cpp, abhängig von der im Beispiel verwendeten Sprache.

Konstruktoren

InstalledProductRegistrationAttribute(String, String, String)

Erstellt ein neues InstalledProductRegistrationAttribute zum Registrieren Ihres Pakets im Dialogfeld Hilfe/Info. Dies sind die einfachsten Registrierungsinformationen, die für Drittanbieterpakete erforderlich sind. Die Angabe von Produktdetails ist keine Anforderung, wird jedoch empfohlen.

Eigenschaften

IconResourceID	Ressourcen-ID des Symbols.
LanguageIndependentName	Der Name Ihres Produkts.
ProductDetails	Detaillierte Beschreibung Ihres Produkts.
ProductDetailsResourceID	Ressourcen-ID für die Details.
ProductId	Ihre Produkt-ID.
ProductName	Der Name Ihres Produkts.
ProductNameResourceID	Ressourcen-ID, die dem Produktnamen entspricht.
TypeId	Überschreiben Sie die TypeID-Eigenschaft, damit die von RegistrationAttribute abgeleiteten Klassen mit System.ComponentModel.TypeDescriptor.GetAttributes(...) arbeiten können. Ein von diesem abgeleitetes Attribut muss diese Eigenschaft nur überschreiben, wenn es ein besseres Steuerelement für die Instanzen benötigt, die auf eine Klasse angewendet werden können. (Geerbt von RegistrationAttribute)
UseInterface	Verwenden Sie IVsInstalledProduct, um das Dialogfeld Hilfe zu ausfüllen. Das Paket muss IVsInstalledProduct implementieren.
UsePackage	True ist, dass die Produktinstallation die Paket-ID verwendet.
UseVsProductId	True ist, dass die Produkt-ID mit der VisualStudio-ID identisch ist. Dies ist für die interne Verwendung von Microsoft reserviert. Pakete von Drittanbietern sollten ihre eigene Produkt-ID angeben, wenn die Klasse erstellt wird.

Methoden

GetPackageRegKeyPath(Guid)	Ruft den Registrierungspfad (relativ zum Registrierungsstamm der Anwendung) des VSPackages ab. (Geerbt von RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Wird aufgerufen, um dieses Attribut für den angegebenen Kontext zu registrieren.
Unregister(RegistrationAttribute+RegistrationContext)	Heben Sie die Registrierung dieses Eintrags "InstalledProducts" auf.

Gilt für:

Freigeben über