Registro de plantillas para proyectos y elementos

Los tipos de proyecto deben registrar los directorios donde se encuentran sus plantillas de proyecto y elemento de proyecto. Visual Studio usa la información de registro asociada a los tipos de proyecto para determinar qué mostrar en los cuadros de diálogo Agregar nuevo proyecto y Agregar nuevo elemento .

Para obtener más información sobre las plantillas, vea Agregar plantillas de proyecto y elemento de proyecto.

Entradas del Registro para proyectos

En los ejemplos siguientes se muestran las entradas del Registro en HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\<Version>. Las tablas adjuntas explican los elementos usados en los ejemplos.

[Projects\{ProjectGUID}]
@="MyProjectType"
"DisplayName"="#2"
"Package"="{VSPackageGUID}"
"ProjectTemplatesDir"="C:\\MyProduct\\MyProjectTemplates"
Nombre Tipo Descripción
@ REG_SZ Nombre predeterminado de los proyectos de este tipo.
Nombre para mostrar REG_SZ Identificador de recurso del nombre que se va a recuperar del archivo DLL satélite registrado en Paquetes.
Paquete REG_SZ Id. de clase del paquete registrado en Paquetes.
ProjectTemplatesDir REG_SZ Ruta de acceso predeterminada de los archivos de plantilla de proyecto. La plantilla Nuevo proyecto muestra los archivos de plantilla de proyecto .

Registro de plantillas de elemento

Debe registrar el directorio donde se almacenan las plantillas de elementos.

[Projects\{ProjectGUID}\AddItemTemplates\TemplateDirs\{VSPackageGUID}\1]
@="#7"
"TemplatesDir"="C:\\MyProduct\\MyProjectItemTemplates "
"TemplatesLocalizedSubDir"="#10"
"SortPriority"=dword:00000064
Nombre Tipo Descripción
@ REG_SZ Identificador de recurso para agregar plantillas de elemento.
TemplatesDir REG_SZ Ruta de acceso de los elementos del proyecto que se muestran en el cuadro de diálogo para el Asistente para agregar nuevo elemento .
TemplatesLocalizedSubDir REG_SZ Identificador de recurso de una cadena que asigna un nombre al subdirectorio de TemplatesDir que contiene plantillas localizadas. Dado que Visual Studio carga el recurso de cadena de archivos DLL satélite si los tiene, cada DLL satélite puede contener un nombre de subdirectorio localizado diferente.
SortPriority REG_DWORD Establezca SortPriority para controlar el orden en el que se muestran las plantillas en el cuadro de diálogo Agregar nuevo elemento . Los valores de SortPriority más grandes aparecen anteriormente en la lista de plantillas.

Registro de filtros de archivo

Opcionalmente, puede registrar filtros que Visual Studio usa cuando solicita nombres de archivo. Por ejemplo, el filtro de Visual C# para el cuadro de diálogo Abrir archivo es:

Archivos de Visual C# (*.cs,*.resx,*.settings,*.xsd,*.wsdl);*.cs,*.resx,*.settings,*.xsd,*.wsdl)

Para admitir el registro de varios filtros, cada filtro se registra en su propia subclave en HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\Version>\<Projects\{<ProjectGUID>}\Filters\<Subkey.> El nombre de la subclave es arbitrario; Visual Studio omite el nombre de la subclave y usa solo sus valores.

Puede controlar los contextos en los que se usa un filtro estableciendo marcas, que se muestran en la tabla siguiente. Si un filtro no tiene ninguna marca establecida, se mostrará después de los filtros comunes en el cuadro de diálogo Agregar elemento existente y el cuadro de diálogo Abrir archivo , pero no se usará en el cuadro de diálogo Buscar en archivos .

[Projects\{ProjectGUID}\Filters\MyLanguageFilter]
@="#3"
"CommonOpenFilesFilter"=dword:00000000
"CommonFindFilesFilter"=dword:00000000
"FindInFilesFilter"=dword:00000000
"NotOpenFileFilter"=dword:00000000
"NotAddExistingItemFilter"=dword:00000000
"SortPriority"=dword:00000064
Nombre Tipo Descripción
CommonFindFilesFilter REG_DWORD Convierte el filtro en uno de los filtros comunes en el cuadro de diálogo Buscar en archivos . Los filtros comunes se enumeran en la lista de filtros antes de que los filtros no estén marcados como comunes.
CommonOpenFilesFilter REG_DWORD Convierte el filtro en uno de los filtros comunes en el cuadro de diálogo Abrir archivo . Los filtros comunes se enumeran en la lista de filtros antes de que los filtros no estén marcados como comunes.
FindInFilesFilter REG_DWORD Muestra el filtro después de los filtros comunes en el cuadro de diálogo Buscar en archivos .
NotOpenFileFilter REG_DWORD Indica que el filtro no se usa en el cuadro de diálogo Abrir archivo .
NotAddExistingItemFilter REG_DWORD Indica que el filtro no se usa en el cuadro de diálogo Agregar elemento existente.
SortPriority REG_DWORD Establezca SortPriority para controlar el orden en el que se muestran los filtros. Los valores de SortPriority más grandes aparecen anteriormente en la lista de filtros.

Estructura de directorios

VSPackages puede colocar archivos de plantilla y carpetas en cualquier lugar de un disco local o remoto, siempre y cuando la ubicación se registre a través del entorno de desarrollo integrado (IDE). Sin embargo, para facilitar la organización, se recomienda la siguiente estructura de directorios en la ruta de instalación del producto.

\Plantillas

\Projects (contiene las plantillas de proyecto)

\Applications

\Componentes

\ ...

\ProjectItems (contiene los elementos del proyecto)

\Clase

\Forma

\Página web

\HelperFiles (contiene los archivos usados en elementos de proyecto de varios archivos)

\WizardFiles

Consulte también