ProvideMenuResourceAttribute 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.

Fornisce informazioni di registrazione sulle risorse di menu utilizzate in un pacchetto VSPackage. La classe non può essere ereditata.

public ref class ProvideMenuResourceAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

public ref class ProvideMenuResourceAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideMenuResourceAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideMenuResourceAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class ProvideMenuResourceAttribute
Inherits RegistrationAttribute

Ereditarietà: Attribute

RegistrationAttribute
ProvideMenuResourceAttribute

Attributi: AttributeUsageAttribute

Commenti

Quando chiamare

Applicare a ProvideMenuResourceAttribute una classe o a una Microsoft.VisualStudio.Packageclasse derivata da che implementa IVsPackage se la classe contiene una o più risorse di menu. Registrare le risorse con regpkg.exe o uno strumento di registrazione simile. Per altre informazioni, vedere Registrazione di PACCHETTI VSPackage.

Utilizzo di base

La ProvideMenuResourceAttribute classe definisce l'ID risorsa e il numero di versione di una risorsa di menu, consentendo a uno strumento di registrazione, ad esempio regpkg.exe di registrare la risorsa di menu con Visual Studio. Quando Visual Studio rileva un VSPackage con una risorsa di menu registrata, recupera le informazioni sulla risorsa dal PACCHETTO VSPackage o dalla DLL satellite o gestita del pacchetto e unisce il menu nel sistema di menu di Visual Studio. Per usare ProvideMenuResourceAttribute, inserirlo in una classe o in una Packageclasse derivata da che implementa IVsPackage.

Affinché la risorsa di menu venga eseguita correttamente, la DLL della risorsa deve seguire le convenzioni della DLL satellite. Deve essere denominato <assemblyfile>UI.dll e inserito in una sottodirectory localizzata appropriata. Per altre informazioni sui menu e sulle risorse di menu, vedere How VSPackages Add User Interface Elements and Commands, Menus, and Toolbars.For additional information on menu and menu resources, see How VSPackages Add User Interface Elements and Commands, Menus, and Toolbars.

Questa classe di attributi viene usata solo per fornire dati per gli strumenti di registrazione esterni. Non ha alcun effetto sul comportamento in fase di esecuzione del VSPackage.

Nota

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

Voci del Registro di sistema

Le voci del Registro di sistema seguenti vengono create da ProvideMenuResourceAttribute:
<VSROOT>\Menus\
<VSROOT>\Menus\{PackageGuid}=", ResourceID, version"

Esempi

È possibile trovare le implementazioni della ProvideMenuResourceAttribute classe negli esempi gestiti. Il percorso standard per questo e tutti gli altri attributi usati per la registrazione automatica sono adiacenti all'implementazione della Package classe in VsPkg.cs, VsPkg.vb o VsPkg.cpp, a seconda del linguaggio usato nell'esempio.

Costruttori

ProvideMenuResourceAttribute(Int16, Int32)	Questo costruttore crea un nuovo oggetto ProvideMenuResourceAttribute con l'ID risorsa e il numero di versione specificati.
ProvideMenuResourceAttribute(String, Int32)	Inizializza una nuova istanza di ProvideMenuResourceAttribute con l'ID risorsa e la versione specificati.

Proprietà

IconMappingFilename	Percorso di un file CSV che esegue il mapping degli identificatori di icona definiti nella risorsa di menu ai moniker di immagine. Il percorso è un percorso relativo basato in modo implicito su $PackageFolder$o un percorso assoluto in una directory definita da una variabile di ambiente,ad esempio "%UserProfile%\dir1\dir2\MyMappingFile.csv". Il formato del file CSV è: `Icon guid, Icon id, Moniker guid, Moniker id b714fcf7-855e-4e4c-802a-1fd87144ccad,1,fda30684-682d-421c-8be4-650a2967058e,100 {b714fcf7-855e-4e4c-802a-1fd87144ccad},2,{fda30684-682d-421c-8be4-650a2967058e},200 etc...`
ResourceID	La proprietà ResourceID restituisce il valore dell'ID risorsa impostato nel costruttore.
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)
Version	Restituisce il numero di versione della risorsa di menu.

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)	Fornisce informazioni di registrazione su un pacchetto VSPackage quando viene chiamato da uno strumento di registrazione esterno, ad esempio regpkg.exe. Per altre informazioni, vedere Registrazione di PACCHETTI VSPackage.
Unregister(RegistrationAttribute+RegistrationContext)	Chiamato per annullare la registrazione di questo attributo con il contesto specificato.

Si applica a

Condividi tramite