Cómo: Agregar referencias a las plantillas

Artículo
10/07/2008

Actualización: noviembre 2007

Utilice estos procedimientos para crear plantillas que contienen referencias a ensamblados.

Agregar referencias en plantillas de proyecto

Las plantillas de proyecto siempre incluyen un archivo de proyecto, lo que permite agregar o quitar referencias en la plantilla.

Para agregar referencias en las plantillas de proyecto

En el menú Archivo, haga clic en Nuevo y, a continuación, haga clic en Proyecto.
En el cuadro de diálogo Nuevo proyecto, seleccione la plantilla que desee actualizar, escriba un nombre y una ubicación para el proyecto y haga clic en Aceptar.
Agregue o quite las referencias al proyecto desde el cuadro de diálogo Agregar referencia. Para obtener más información sobre cómo agregar referencias, vea Cómo: Agregar o quitar referencias en Visual Studio (Visual Basic).
Utilice el asistente Exportar plantilla para crear una nueva plantilla. Para obtener más información, vea Cómo: Crear Starter Kits.
Cuando la plantilla actualizada se comprima en un archivo .zip, elimine el archivo .zip de la plantilla anterior.

Agregar referencias en plantillas de elementos

Las plantillas de elementos no contienen archivos de proyecto; por este motivo, agregar referencias a las plantillas de elementos es diferente que a las de proyecto. Puede agregar referencias a las plantillas de elementos a través del asistente Exportar plantilla o editando manualmente el archivo .vstemplate en la plantilla.

Nota:
Para que la plantilla funcione correctamente, cada equipo que la utiliza debe tener instalados todos los ensamblados a los que haga referencia. Si existe la posibilidad de que algunos equipos no tengan instalados los ensamblados, deberá compartirlos en la misma ubicación de uso compartido de la plantilla y los usuarios los deberán instalar en sus equipos. Para obtener información sobre cómo instalar ensamblados, vea Cómo: Instalar un ensamblado en la memoria Caché de ensamblados global.

Para que la plantilla funcione correctamente, cada equipo que la utiliza debe tener instalados todos los ensamblados a los que haga referencia. Si existe la posibilidad de que algunos equipos no tengan instalados los ensamblados, deberá compartirlos en la misma ubicación de uso compartido de la plantilla y los usuarios los deberán instalar en sus equipos. Para obtener información sobre cómo instalar ensamblados, vea Cómo: Instalar un ensamblado en la memoria Caché de ensamblados global.

Para utilizar el asistente Exportar plantilla para agregar referencias en plantillas de elementos

Cree o abra un proyecto en Visual Studio.
Agregue un elemento al proyecto y modifíquelo si es necesario.
En el menú Archivo, haga clic en Exportar plantilla.
Haga clic en Plantilla de elemento, seleccione el proyecto que contiene el elemento y haga clic en Siguiente.
Seleccione el elemento para el que desea crear la plantilla y haga clic en Siguiente.

Seleccione las referencias de ensamblado que vaya a incluir en la plantilla y haga clic en Siguiente.

Nota:
La lista de ensamblados se genera a partir de las referencias de ensamblado del proyecto actual. Si el ensamblado al que desee hacer referencia no aparece en la lista, salga del asistente, agregue la referencia al proyecto y vuelva a ejecutar el asistente.

Escriba el nombre del archivo de icono, el nombre de plantilla y la descripción de la plantilla y haga clic en Finalizar.
Si ha modificado una plantilla existente, elimine el archivo .zip de la plantilla anterior.

Como alternativa, puede editar manualmente el archivo .vstemplate para agregar las referencias a la plantilla de elemento.

Para agregar manualmente referencias en plantillas de elementos

Busque el archivo .zip que contiene la plantilla.
Extraiga el archivo . zip.
Abra el archivo .vstemplate en Visual Studio.
En el elemento TemplateContent, agregue un elemento References.
En el elemento References, agregue uno o más elementos Reference para contener los ensamblados a los que hacer referencia.

En cada elemento Reference, agregue un elemento Assembly con el ensamblado al que hacer referencia. Por ejemplo:

<TemplateContent>
    <References>
        <Reference>
            <Assembly>
                System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
        <Reference>
            <Assembly>
                System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
    </References>
    ...
</TemplateContent>

Nota:
Para hacer referencia a los ensamblados es preciso utilizar su nombres seguros.

Guarde y cierre el archivo .vstemplate.
Seleccione los archivos incluidos en la plantilla, haga clic con el botón secundario del mouse, seleccione Enviar a y haga clic en Carpeta comprimida (en zip). Los archivos seleccionados se comprimen en un archivo .zip.
Elimine los archivos de plantilla extraídos y el archivo .zip de la plantilla anterior.
Coloque el nuevo archivo .zip en el mismo directorio que el archivo .zip eliminado.