Classe InstalledProductRegistrationAttribute

Fornisce informazioni per la schermata iniziale di Visual Studio e la finestra di dialogo La guida su se applicato a Packageclasse derivata da o classe che implementano IVsPackage.questa classe non può essere ereditata.

Gerarchia di ereditarietà

System.Object
  System.Attribute
    Microsoft.VisualStudio.Shell.RegistrationAttribute
      Microsoft.VisualStudio.Shell.InstalledProductRegistrationAttribute

Spazio dei nomi:  Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)

Sintassi

'Dichiarazione
<AttributeUsageAttribute(AttributeTargets.Class, Inherited := False)> _
Public NotInheritable Class InstalledProductRegistrationAttribute _
    Inherits RegistrationAttribute
[AttributeUsageAttribute(AttributeTargets.Class, Inherited = false)]
public sealed class InstalledProductRegistrationAttribute : RegistrationAttribute

Il tipo InstalledProductRegistrationAttribute espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo pubblico InstalledProductRegistrationAttribute(String, String, String) Inizializza una nuova istanza di InstalledProductRegistrationAttribute con le informazioni sul prodotto specificate.
Metodo pubblico InstalledProductRegistrationAttribute(Boolean, String, String, String) Obsoleta. inizializza una nuova istanza di InstalledProductRegistrationAttribute per il prodotto specificato.
Metodo pubblico InstalledProductRegistrationAttribute(String, String, String, Boolean) Inizializza una nuova istanza di InstalledProductRegistrationAttribute che il prodotto specificato in.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica IconResourceID Ottiene o imposta ID di risorsa icona associata al prodotto.
Proprietà pubblica LanguageIndependentName Ottiene o imposta il nome (non localizzato) del prodotto.
Proprietà pubblica ProductDetails Ottiene o imposta la descrizione dettagliata del prodotto.
Proprietà pubblica ProductDetailsResourceID Ottiene o imposta i dettagli del prodotto identificazione delle risorse
Proprietà pubblica ProductId Ottiene o imposta l'id prodotto
Proprietà pubblica ProductName Ottiene o imposta il nome del prodotto.
Proprietà pubblica ProductNameResourceID Ottiene o imposta ID di risorsa del nome del prodotto.
Proprietà pubblica TypeId Ottiene l'istanza corrente dell'attributo. (Ereditato da RegistrationAttribute)
Proprietà pubblica UseInterface Ottiene o se il pacchetto implementa l'interfaccia di IVsInstalledProduct per visualizzare una bitmap nella schermata iniziale e le informazioni nella finestra di dialogo di Su scegliere dal menu di Guida .
Proprietà pubblica UsePackage Ottiene o imposta se l'installazione del prodotto utilizza l'identificazione del pacchetto
Proprietà pubblica UseVsProductId Determina se il controllo ID è lo stesso di identificazione di Visual Studio

In alto

Metodi

  Nome Descrizione
Metodo pubblico Equals Infrastruttura. Restituisce un valore che indica se l'istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
Metodo pubblico GetHashCode Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico IsDefaultAttribute Una volta sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Metodo pubblico Match Una volta sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
Metodo pubblico Register Registra le informazioni su un VSPackage una volta chiamato da uno strumento esterno di registrazione come regpkg.exe. (Esegue l'override di RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext)).
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo pubblico Unregister Rimuove le informazioni di registrazione su un VSPackage una volta chiamato da uno strumento esterno di registrazione come regpkg.exe. (Esegue l'override di RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext)).

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.GetIDsOfNames Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.GetTypeInfo Recupera le informazioni sui tipi per un oggetto, che può essere utilizzato per ottenere informazioni sul tipo per un'interfaccia. (Ereditato da Attribute)
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.GetTypeInfoCount Recupera il numero di interfacce di informazioni sui tipi che un oggetto garantisce (0 o 1). (Ereditato da Attribute)
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.Invoke Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

In alto

Note

Quando eseguire chiamate

Applicare l'attributo alla classe di un VSPackage per fornire informazioni visualizzate nella schermata iniziale di Visual Studio e nella finestra di dialogo di La guida su .

utilizzo di base

Creare un oggetto di InstalledProductRegistrationAttribute per registrare il package VS con la finestra di dialogo di La guida su .I costruttori forniscono diverse opzioni da utilizzare l'interfaccia di IVsInstalledProduct (implementato dal pacchetto) per raccogliere le informazioni e per visualizzare la schermata iniziale di Visual Studio .Per utilizzare questo attributo, inserirlo nella classe di un VSPackage (classe derivata da  Packageo da uno che implementa IVsPackage).

Questo attributo viene utilizzato solo per fornire i dati per strumenti esterni di registrazione come regpkg.exe.Non ha alcun effetto sul comportamento di runtime del package VS.Per ulteriori informazioni, vedere Registrazione di un VSPackage.

[!NOTA]

Visual C# automaticamente aggiunto l'attributo di parola al nome di una classe Attribute.Nel codice di Visual C# , fare riferimento a questo attributo come InstalledProductRegistration.

Voci del Registro di sistema

Le seguenti voci del Registro di sistema vengono create da InstalledProductRegistrationAttribute:

  • <VSROOT> \CLSID\{PackageGuid}

  • <VSROOT> \CLSID\{PackageGuid}\@=ObjectType.FullName

  • <VSROOT> \CLSID\{PackageGuid}\InprocServer 32=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

La posizione standard per questa e tutti gli altri attributi utilizzati per la registrazione automatica è adiacente all'implementazione di Package in VsPkg.cs, VsPkg.vb, o VsPkg.cpp, a seconda del linguaggio utilizzato nell'esempio.

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Shell

Altre risorse

Registrazione di un VSPackage

Risorse localizzate in applicazioni MFC: DLL satellite