Classe ProvideMenuResourceAttribute

  • Articolo

Vengono fornite informazioni di registrazione sulle risorse di menu utilizzate in un VSPackage.questa classe non può essere ereditata.

Gerarchia di ereditarietà

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

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

Sintassi

'Dichiarazione
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True, Inherited := True)> _
Public NotInheritable Class ProvideMenuResourceAttribute _
    Inherits RegistrationAttribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true, Inherited = true)]
public sealed class ProvideMenuResourceAttribute : RegistrationAttribute

Il tipo ProvideMenuResourceAttribute espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo pubblico ProvideMenuResourceAttribute(Int16, Int32) Questo costruttore viene creato un nuovo oggetto di ProvideMenuResourceAttribute con ID di risorsa e il numero di versione specificato.
Metodo pubblico ProvideMenuResourceAttribute(String, Int32) Inizializza una nuova istanza di ProvideMenuResourceAttribute con ID di risorsa e la versione specificati.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica ResourceID La proprietà di ResourceID restituisce il valore dell'ID della risorsa impostato nel costruttore.
Proprietà pubblica TypeId Ottiene l'istanza corrente dell'attributo. (Ereditato da RegistrationAttribute)
Proprietà pubblica Version Restituisce il numero di versione della risorsa menu.

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 Vengono fornite informazioni di registrazione su un VSPackage una volta chiamato da uno strumento esterno di registrazione come regpkg.exe.Per ulteriori informazioni, vedere Registrare package VS.. (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.Per ulteriori informazioni, vedere Registrare package VS.. (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 ProvideMenuResourceAttribute a Microsoft.VisualStudio.Packageclasse derivata dalla classe o che implementano IVsPackage se la classe contiene una o più risorse di menu.Registrare le risorse con regpkg.exe o un come strumento di registrazione.Per ulteriori informazioni, vedere Registrare package VS..

utilizzo di base

La classe di ProvideMenuResourceAttribute definisce ID di risorsa e il numero di versione di una risorsa menu, consentendo a uno strumento di registrazione come regpkg.exe log la risorsa menu con Visual Studio.Quando Visual Studio riscontra un VSPackage con una risorsa menu registrata, recupera le informazioni sulle risorse dal package VS o dalla DLL gestito o satellite del pacchetto e unisce il menu nel menu di sistema di Visual Studio .Per utilizzare ProvideMenuResourceAttribute, collocarlo in Packageclasse derivata dalla classe o che implementano IVsPackage.

Affinché la risorsa menu è stata individuata correttamente, la DLL delle risorse deve seguire convenzioni delle DLL satellite.Deve essere denominato <fileassembly> UI.dll ed essere inserito in una sottodirectory appropriata e localizzata.Per ulteriori informazioni sui menu e delle risorse di menu, vedere Come Vspackage aggiunge gli elementi dell'interfaccia utente dell'IDE e Controlli, menu e barre degli strumenti.

Questa classe Attribute viene utilizzata solo per fornire i dati per strumenti esterni di registrazione.Non ha alcun effetto sul comportamento di runtime del package VS.

[!NOTA]

C# automaticamente aggiunge la parola “attributo„ al nome di una classe Attribute.Nel codice c#, fare riferimento a questo attributo come ProvideMenuResource.

Voci del Registro di sistema

  • Le seguenti voci del Registro di sistema vengono create da ProvideMenuResourceAttribute:

  • <VSROOT> \Menus \

  • <VSROOT> \Menus\{PackageGuid}=", ResourceID, Version„

Esempi

È possibile trovare le implementazioni della classe di ProvideMenuResourceAttribute negli esempi gestiti.La posizione standard per questa e tutti gli altri attributi utilizzati per la registrazione automatica è adiacente all'implementazione della classe 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

Controlli, menu e barre degli strumenti

Risorse localizzate in applicazioni MFC: DLL satellite

Registrare package VS.