InstalledProductRegistrationAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualStudio.Shell

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

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

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Questo attributo registra un "prodotto installato" per il pacchetto.
In questo modo il pacchetto può presentare informazioni sulla schermata iniziale di VISUAL Studio o informazioni sulla Guida.

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

Ereditarietà: Attribute

RegistrationAttribute
InstalledProductRegistrationAttribute

Attributi: AttributeUsageAttribute

Commenti

Quando chiamare

Applicare questo attributo alla classe VSPackage per fornire informazioni visualizzate nella schermata iniziale di Visual Studio e nella finestra di dialogo Informazioni sulla Guida .

Utilizzo di base

Create un InstalledProductRegistrationAttribute oggetto per registrare il VSPackage nella finestra di dialogo Informazioni sulla Guida. I diversi costruttori forniscono le opzioni per usare l'interfaccia IVsInstalledProduct (implementata dal pacchetto) per raccogliere le informazioni e visualizzarla nella schermata iniziale di Visual Studio. Per usare questo attributo, inserirlo nella classe VSPackage (una classe derivata da Package o una classe che implementa IVsPackage).

Questo attributo viene usato solo per fornire dati per strumenti di registrazione esterni come regpkg.exe. Non ha alcun effetto sul comportamento di runtime del VSPackage. Per altre informazioni, vedere VsPackage Registration.For more information, see VSPackage Registration.

Nota

Visual C# aggiunge automaticamente la parola Attribute al nome di qualsiasi classe di attributo. Nel codice Visual C# fare riferimento a questo attributo come InstalledProductRegistration.

Voci del Registro di sistema

Le voci del Registro di sistema seguenti vengono create da 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

Esempi

Il percorso standard per questo e tutti gli altri attributi usati per la registrazione automatica sono adiacenti all'implementazione di Package in VsPkg.cs, VsPkg.vb o VsPkg.cpp, a seconda del linguaggio usato nell'esempio.

Costruttori

InstalledProductRegistrationAttribute(String, String, String)

Crea un nuovo InstalledProductRegistrationAttribute per registrare il pacchetto con la finestra di dialogo ? Si tratta delle informazioni di registrazione più semplici necessarie per i pacchetti di terze parti. Fornire i dettagli del prodotto non è un requisito, ma è consigliabile.

Proprietà

IconResourceID	ID risorsa dell'icona.
LanguageIndependentName	Nome del prodotto.
ProductDetails	Descrizione dettagliata del prodotto.
ProductDetailsResourceID	ID risorsa per i dettagli.
ProductId	ID prodotto.
ProductName	Nome del prodotto.
ProductNameResourceID	ID risorsa corrispondente al nome del prodotto.
TypeId	Eseguire l'override della proprietà TypeID per consentire alle classi derivate RegistrationAttribute di usare System.ComponentModel.TypeDescriptor.GetAttributes(...). Un attributo derivato da questo deve eseguire l'override di questa proprietà solo se necessita di un controllo migliore sulle istanze che possono essere applicate a una classe. (Ereditato da RegistrationAttribute)
UseInterface	Usare IVsInstalledProduct per compilare la finestra di dialogo ? Il pacchetto deve implementare IVsInstalledProduct.
UsePackage	True è che l'installazione del prodotto userà l'ID pacchetto
UseVsProductId	True è l'ID prodotto uguale a VisualStudio ID Riservato all'uso interno di Microsoft. I pacchetti di terze parti devono fornire il proprio ID prodotto quando viene costruita la classe .

Metodi

GetPackageRegKeyPath(Guid)	Ottiene il percorso del Registro di sistema (relativo alla radice del Registro di sistema dell'applicazione) del pacchetto VS. (Ereditato da RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Chiamato per registrare questo attributo con il contesto specificato.
Unregister(RegistrationAttribute+RegistrationContext)	Annullare la registrazione della voce InstalledProducts.

Si applica a

Condividi tramite