Compatibilidad con las categorías de configuración

Una categoría de configuración se compone de un grupo de opciones que personalizan el entorno de desarrollo (IDE) integrado. Por ejemplo, los valores pueden controlar el diseño de ventanas de Visual Studio y del contenido de menús. Para obtener más información, vea Personalizar la configuración de desarrollo en Visual Studio.

Haga clic en Importar y exportar configuraciones de menú de Herramientas para iniciar Asistente de los valores de importación y exportación. El asistente proporciona tres opciones: exportación, import, o para restablecer los valores. La selección de exportación, por ejemplo, abra la página de elija los valores para exportar del asistente.

El control de árbol en el panel de navegación de esta página muestra categorías. Una categoría es un grupo de valores relacionados que aparecen como un “punto de configuración personalizado”, es decir, como casilla. Utiliza estas casillas para seleccionar las categorías para conservar en un archivo de .vsettings. El asistente le permite llamar al archivo de .vsettings y especificar su ruta de acceso.

Nota
Los valores se guardan o se restablecen como categoría, y los nombres individuales de valores no se muestran en el asistente.

El (MPF) managed package permite crear categorías de configuración con un mínimo de código adicional.

• Crea un VSPackage para proporcionar un contenedor para la categoría crear subclases de la clase de Package .

• Crea la categoría propia derivándola de la clase de DialogPage .

• Se conecta ambos con ProvideProfileAttribute.

Compatibilidad con las categorías de configuración

La clase de Package proporciona compatibilidad para crear categorías. la clase de DialogPage implementa una categoría. la implementación predeterminada de DialogPage proporciona sus propiedades públicas a un usuario como categoría. Para obtener más información, vea tutorial: crear una categoría de configuración.

La clase de DialogPage implementa IProfileManager, que proporciona la persistencia para páginas opciones y del usuario. El LoadSettingsFromXml y los métodos de SaveSettingsToXml conservan los valores en un archivo .vssettings que Visual Studio proporcione como IVsSettingsReader o IVsSettingsWriter, respectivamente. El método de ResetSettings restaura configuración a sus valores predeterminados.

La clase de DialogPage proporciona una implementación del método de LoadSettingsFromXml que lee pares nombre-valor de la fuente de XML, y utiliza la reflexión para detectar propiedades públicas en la clase derivada de DialogPage . Las propiedades que tienen nombres que coinciden con los pares nombre-valor se les asignan valores correspondientes.

La implementación predeterminada de SaveSettingsToXml utiliza la reflexión para detectar propiedades públicas en la clase derivada de DialogPage y escribe los nombres de propiedad y los valores a la fuente XML como pares de nombre y valor.

Ruta de acceso de registro de la categoría de configuración

La ruta de acceso de registro de la categoría de configuración se determina mediante la combinación ApplicationRegistryRoot, word, UserSettings, categoría de configuración, y el nombre del punto de configuración personalizado. Los nombres de punto de valores de categoría de configuración y personalizadas son join y separados por un carácter de subrayado para formar el nombre canónico, no traducido que aparece en el registro. Por ejemplo, si la categoría de configuración es “mi categoría”, el nombre personalizado de punto de valores “my valores”, y el \SOFTWARE\Microsoft\VisualStudio\8.0Exp, then the settings category has the registry key, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Exp\UserSettings\My Category_My Settings de ApplicationRegistryRoot HKEY_LOCAL_MACHINE.

Nota
el nombre canónico no aparece en una interfaz de usuario (UI).Se utiliza para asociar un nombre legible a la categoría de configuración, como un identificador de programación (ProgID).

Atributo de categoría de configuración

ProvideProfileAttribute determina la asignación de categorías a los puntos de valores personalizados en Asistente de los valores de importación y exportación asociando una categoría al Paquete que la proporciona. Observe el fragmento de código siguiente:

<ProvideProfile(GetType(OptionsPageGeneral), "My Category", "My Settings", 106, 107, True, DescriptionResourceID:=108),
 Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")>
Public Class MyPackage
    Inherits Package

[ProvideProfile(typeof(OptionsPageGeneral),"My Category", "My Settings", 106, 107, true, DescriptionResourceID = 108)]
[Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")]
public class MyPackage : Package

Id. de recurso 106 se asigna a “mi categoría”, 107 a “my valores”, y 108 a las “opciones de Distintos”. Esto declara que MyPackage proporciona la categoría, los valores de Category_My. la categoría es proporcionada por la clase de OptionsPageGeneral , que debe implementar IProfileManager. Los valores de esa categoría son las propiedades públicas de la clase de OptionsPageGeneral .

En Asistente de los valores de importación y exportación, el punto de valores es el nombre, los valores. Cuando el punto de valores está seleccionado, la descripción, Distintas opciones, aparece. El nombre y la descripción del punto de valores se toman de recursos de cadena traducidos.

Vea también

Tareas

tutorial: crear una página opciones

Conceptos

Ejemplos de extensibilidad de Visual Studio

Personalizar la configuración de desarrollo en Visual Studio

Otros recursos

estado de VSPackage