Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Un VSPackage puede definir una o varias categorías de configuración, que son grupos de variables de estado que persisten cuando un usuario elige el comando Importar/Exportar configuración en el menú Herramientas . Para habilitar esta persistencia, use las API de configuración en el SDK de Visual Studio.
Una entrada del Registro a la que se hace referencia como punto de configuración personalizada y un GUID define la categoría de configuración de VSPackage. Un VSPackage puede admitir varias categorías de configuración, cada una definida por un punto de configuración personalizado.
Las implementaciones de la configuración que se basan en ensamblados de interoperabilidad, utilizando la interfaz IVsUserSettings, deben crear un Punto de Configuración Personalizado ya sea editando el registro o usando un script de registrador (archivo .rgs). Para obtener más información, consulte Creación de scripts de registrador.
El código que usa el Managed Package Framework (MPF) debe crear Puntos de Configuración Personalizados adjuntando un elemento ProvideProfileAttribute al VSPackage por cada Punto de Configuración Personalizado.
Si un único VSPackage admite varios puntos de configuración personalizados, cada punto de configuración personalizado se implementa mediante una clase independiente y cada uno se registra mediante una instancia única de la ProvideProfileAttribute clase . Por lo tanto, una clase que implementa configuraciones puede admitir más de una categoría de configuración.
Detalles de entrada del Registro del punto de configuración personalizado
Los puntos de configuración personalizados se crean en una entrada del Registro en la siguiente ubicación: HKLM\Software\Microsoft\VisualStudio\Version<\>UserSettings\<CSPName>, donde <CSPName> es el nombre del punto de configuración personalizado que admite VSPackage y <Version> es la versión de Visual Studio, por ejemplo 8.0.
Nota:
La ruta de acceso raíz de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> se puede sobrescribir con una raíz alternativa cuando se inicializa el entorno de desarrollo integrado (IDE) de Visual Studio. Para obtener más información, consulte Modificadores de Línea de Comandos.
A continuación se muestra la estructura de la entrada del Registro:
HKLM\Software\Microsoft\VisualStudio\<Version>\UserSettings\
<CSPName
>= s '#12345'
Package = '{XXXXXX XXXX XXXX XXXX XXXXXXXXX}'
Category = '{AAAAYYY AAAAYYYYYYYY}'
ResourcePackage = '{ZZZZZZ ZZZZ ZZZZ ZZZZ ZZZZZZZZZ}'
AlternateParent = CategoryName
| Nombre | Tipo | Data | Description |
|---|---|---|---|
| (Valor predeterminado) | REG_SZ | Nombre del punto de configuración personalizado | El nombre de la clave, <CSPName>, es el nombre no localizado del punto de configuración personalizada.Para las implementaciones basadas en MPF, el nombre de la clave se obtiene mediante la combinación de los argumentos categoryName y objectName del constructor ProvideProfileAttribute en categoryName_objectName.La clave puede estar vacía o puede contener el ID de referencia a la cadena localizada en un DLL satélite. Este valor se obtiene del argumento objectNameResourceID en el constructor ProvideProfileAttribute. |
| Package | REG_SZ | Identificador Único Global (GUID) | El GUID del VSPackage que implementa el Punto de Configuración Personalizado. Implementaciones basadas en MPF mediante la ProvideProfileAttribute clase, usan el argumento del objectType constructor que contiene el VSPackage y Type la reflexión para obtener este valor. |
| Categoría | REG_SZ | Identificador Único Global (GUID) | GUID que identifica la categoría de configuración. Para implementaciones basadas en ensamblados de interoperabilidad, este valor puede ser un GUID seleccionado arbitrariamente, que el IDE de Visual Studio pasa a los métodos ExportSettings y ImportSettings. Todas las implementaciones de estos dos métodos deben comprobar sus argumentos GUID. En el caso de las implementaciones basadas en MPF, este GUID se obtiene mediante la Type de la clase que implementa el mecanismo de configuración de Visual Studio. |
| ResourcePackage | REG_SZ | Identificador Único Global (GUID) | Optional. Ruta de acceso a la DLL satélite que contiene cadenas localizadas, en caso de que el VSPackage de implementación no las proporcione. MPF usa la reflexión para obtener el recurso correcto VSPackage, por lo que la ProvideProfileAttribute clase no establece este argumento. |
| Padre Alternativo | REG_SZ | Nombre de la carpeta en la página Opciones de herramientas que contiene este punto de configuración personalizado. | Optional. Debe establecer este valor solo si una implementación de configuración admite páginas de opciones de herramientas que usan el mecanismo de persistencia en el SDK de Visual Studio en lugar del mecanismo en el modelo de automatización para guardar el estado. En estos casos, el valor de la clave AlternateParent es la topic sección de la topic.sub-topic cadena utilizada para identificar la página ToolsOptions determinada. Por ejemplo, para la página "TextEditor.Basic", el valor de AlternateParent sería "TextEditor".Cuando ProvideProfileAttribute genera el punto de configuración personalizada, es el mismo que el nombre de la categoría. |