ProvideMenuResourceAttribute Clase

Definición

Espacio de nombres:

Microsoft.VisualStudio.Shell

Ensamblado:

Microsoft.VisualStudio.Shell.15.0.dll

Paquete:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Proporciona información de registro sobre los recursos de menú usados en un VSPackage. Esta clase no puede heredarse.

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

Herencia

Attribute

RegistrationAttribute

ProvideMenuResourceAttribute

Atributos

AttributeUsageAttribute

Comentarios

Cuándo llamar

Aplique a ProvideMenuResourceAttribute una Microsoft.VisualStudio.Packageclase o clase derivada de que implemente IVsPackage si la clase contiene uno o varios recursos de menú. Registre los recursos con regpkg.exe o una herramienta de registro similar. Para obtener más información, consulte Registro de VSPackages.

Uso básico

La ProvideMenuResourceAttribute clase define el identificador de recurso y el número de versión de un recurso de menú, lo que permite que una herramienta de registro como regpkg.exe registre el recurso de menú con Visual Studio. Cuando Visual Studio encuentra un VSPackage con un recurso de menú registrado, recupera la información de recursos de VSPackage o el archivo DLL administrado o satélite del paquete y combina el menú en el sistema de menús de Visual Studio. Para usar ProvideMenuResourceAttribute, colóquelo en una Packageclase o clase derivada de que implemente IVsPackage.

Para que el recurso de menú se combine correctamente, el archivo DLL de recursos debe seguir las convenciones de DLL satélite. Debe denominarse <assemblyfile>UI.dll y colocarlo en un subdirectorio localizado adecuado. Para obtener información adicional sobre los menús y los recursos de menú, vea How VSPackages Add User Interface Elements and Commands, Menus, and Toolbars.

Esta clase de atributo solo se usa para proporcionar datos para herramientas de registro externas. No tiene ningún efecto en el comportamiento en tiempo de ejecución de VSPackage.

Nota

C# anexa automáticamente la palabra "Attribute" al nombre de cualquier clase de atributo. En el código de C#, consulte este atributo como ProvideMenuResource.

Entradas del Registro

• Las siguientes entradas del Registro se crean mediante ProvideMenuResourceAttribute:

• <VSROOT>\Menus\

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

Ejemplos

Puede encontrar implementaciones de la ProvideMenuResourceAttribute clase en los ejemplos administrados. La ubicación estándar para este y todos los demás atributos usados para el registro automático son adyacentes a la implementación de la Package clase en VsPkg.cs, VsPkg.vb o VsPkg.cpp, en función del idioma usado en el ejemplo.

Constructores

ProvideMenuResourceAttribute(Int16, Int32)	Este constructor crea un nuevo objeto ProvideMenuResourceAttribute con el identificador de recurso y el número de versión especificados.
ProvideMenuResourceAttribute(String, Int32)	Inicializa una nueva instancia de ProvideMenuResourceAttribute con el la versión y el identificador de recurso especificados.

Propiedades

IconMappingFilename	Ruta de acceso a un archivo CSV que asigna los identificadores de icono definidos en el recurso de menú a monikers de imagen. La ruta de acceso es una ruta de acceso relativa que se basa implícitamente en $PackageFolder$, o una ruta de acceso absoluta explícitamente rootada en un directorio definido por una variable de entorno (por ejemplo, "%UserProfile%\dir1\dir2\MyMappingFile.csv"). El formato del archivo CSV es: 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 propiedad ResourceID devuelve el valor del identificador de recurso establecido en el constructor.
TypeId	Invalide la propiedad TypeID para permitir que las clases derivadas RegistrationAttribute funcionen con System.ComponentModel.TypeDescriptor.GetAttributes(...). Un atributo derivado de este tendrá que invalidar esta propiedad solo si necesita un mejor control en las instancias que se pueden aplicar a una clase. (Heredado de RegistrationAttribute)
Version	Devuelve el número de versión del recurso de menú.

Métodos

GetPackageRegKeyPath(Guid)	Obtiene la ruta del Registro (en relación con la raíz del Registro de la aplicación) del Paquete VSPackage. (Heredado de RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Proporciona información de registro sobre un VSPackage cuando lo llama una herramienta externa de registro como regpkg.exe. Para obtener más información, consulte Registro de VSPackages.
Unregister(RegistrationAttribute+RegistrationContext)	Se usa para eliminar del registro este atributo con el contexto determinado.