Partager via


ProvideMenuResourceAttribute, classe

Fournit les informations d'inscription sur des ressources menu utilisées dans un VSPackage.Cette classe ne peut pas être héritée.

Hiérarchie d'héritage

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

Espace de noms :  Microsoft.VisualStudio.Shell
Assembly :  Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)

Syntaxe

'Déclaration
<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

Le type ProvideMenuResourceAttribute expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique ProvideMenuResourceAttribute(Int16, Int32) Ce constructeur crée un nouvel objet d'ProvideMenuResourceAttribute avec l'ID de ressource et le numéro de version donnés.
Méthode publique ProvideMenuResourceAttribute(String, Int32) Initialise une nouvelle instance d'ProvideMenuResourceAttribute avec l'ID de ressource et la version spécifiés.

Début

Propriétés

  Nom Description
Propriété publique ResourceID La propriété d'ResourceID retourne la valeur de l'ID de ressource défini dans le constructeur.
Propriété publique TypeId Obtient l'instance actuel de cet attribut. (Hérité de RegistrationAttribute.)
Propriété publique Version Retourne le numéro de version de la ressource menu.

Début

Méthodes

  Nom Description
Méthode publique Equals Infrastructure. Retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetHashCode Retourne le code de hachage de cette instance. (Hérité de Attribute.)
Méthode protégée GetPackageRegKeyPath Obtient le chemin d'accès au Registre (par rapport à la racine de Registre de l'application) du VSPackage. (Hérité de RegistrationAttribute.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique IsDefaultAttribute En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute.)
Méthode publique Match En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publique Register Fournit les informations d'inscription sur un VSPackage une fois appelé par un outil externe d'alignement tel que regpkg.exe.Pour plus d'informations, consultez Stocker les VSPackages. (Substitue RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext).)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publique Unregister Supprime les informations d'inscription sur un VSPackage une fois appelé par un outil externe d'alignement tel que regpkg.exe.Pour plus d'informations, consultez Stocker les VSPackages. (Substitue RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext).)

Début

Implémentations d'interface explicite

  Nom Description
Implémentation d'interface expliciteMéthode privée _Attribute.GetIDsOfNames Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée _Attribute.GetTypeInfo Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée _Attribute.GetTypeInfoCount Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée _Attribute.Invoke Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute.)

Début

Remarques

Lorsque appeler

Appliquez-vous ProvideMenuResourceAttribute à - Microsoft.VisualStudio.Package la classe dérivée ou la classe qui implémentent IVsPackage si la classe contient un ou plusieurs ressources menu.Enregistrez les ressources avec regpkg.exe ou un outil similaire d'alignement.Pour plus d'informations, consultez Stocker les VSPackages.

Utilisation de base

La classe d'ProvideMenuResourceAttribute définit l'ID de ressource et le numéro de version d'une ressource menu, ce qui permet à un outil d'alignement tel que regpkg.exe pour enregistrer la ressource menu avec Visual Studio.Lorsque Visual Studio rencontre un VSPackage avec une ressource menu enregistrée, il extrait les informations sur les ressources du VSPackage ou du package géré ou du DLL satellite et fusionne le menu dans le système de menus de Visual Studio.Pour utiliser ProvideMenuResourceAttribute, placez- sur Package - la classe dérivée ou la classe qui implémentent IVsPackage.

Pour que la ressource menu fusionne correctement, le DLL de ressource doit suivre les conventions de DLL satellite.Il doit être nommé <assemblyfile>ui.dll, et être placé dans un sous-répertoire approprié et localisé.Pour plus d'informations sur des menus et des ressources menu, consultez Comment les VSPackages ajoutent des éléments de l'interface utilisateur à l'IDE et le commandes, menus, et barres d'outils.

Cette classe d'attributs est seulement utilisée pour fournir des données pour les outils externes d'alignement.Il n'a aucun effet sur le comportement à l'exécution du VSPackage.

[!REMARQUE]

Le C- ajoute automatiquement le mot « attribut » au nom de toute classe d'attributs.Dans le code C-, reportez -vous à cet attribut comme ProvideMenuResource.

Entrées du Registre

  • Les entrées du Registre suivantes sont créées par ProvideMenuResourceAttribute :

  • <VSROOT>\Menus\

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

Exemples

Vous pouvez rechercher des implémentations de la classe d'ProvideMenuResourceAttribute dans les exemples managés.L'emplacement standard pour cela et toutes les autres l'attribue utilisé pour l'alignement automatique est en regard de l'implémentation de la classe d'Package dans VsPkg.cs, VsPkg.vb, ou VsPkg.cpp, selon le langage utilisé dans l'exemple.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.VisualStudio.Shell, espace de noms

Autres ressources

commandes, menus, et barres d'outils

Ressources localisées dans des applications MFC : DLL satellites

Stocker les VSPackages