Introducción a las plantillas de proyecto de Office

Las Microsoft Office Developer Tools en Visual Studio incluye plantillas de proyecto para crear los siguientes tipos de soluciones de Office:

  • Personalizaciones de nivel de documento

  • Complementos de VSTO

    Para obtener una comparación detallada de estos tipos de soluciones de Office, consulte Introducción al desarrollo de soluciones de Office (VSTO).

    Las plantillas de proyecto de Office están disponibles en el cuadro de diálogo Nuevo proyecto , bajo el nodo Office de los nodos de los lenguajes Visual C# y Visual Basic . Cada plantilla genera un proyecto con la configuración adecuada para la aplicación de destino, incluidas las referencias de ensamblado y la configuración de depuración.

    Cada proyecto proporciona archivos y código a modo de introducción a un tipo específico de solución. El código generado para cada proyecto incluye controladores de eventos de inicio y cierre. Puede agregar código a estos controladores de eventos para inicializar la solución cuando se cargue y para limpiarla cuando se descargue. Para obtener más información, vea Proyectos de Office en el entorno de Visual Studio y Eventos en proyectos de Office.

Nota:

Las herramientas de desarrollo de Office se incluyen con algunas ediciones de Visual Studio. Para obtener más información, vea Configurar un equipo para desarrollar soluciones de Office.

Personalizaciones de nivel de documento

El nodo Office del cuadro de diálogo Nuevo proyecto proporciona las siguientes plantillas de proyecto como punto de partida para crear personalizaciones de documentos para Word y Excel:

  • Documento de VSTO de Word 2013 y 2016

  • Plantilla de VSTO de Word 2013 y 2016

  • Libro de VSTO de Excel 2013 y 2016

  • Plantilla de VSTO de Excel 2013 y 2016

  • Documento de VSTO de Word 2010

  • Plantilla de VSTO de Word 2010

  • Libro de VSTO de Excel 2010

  • Plantilla de VSTO de Excel 2010

    Las plantillas de proyecto de libro de Excel y documento de Word proporcionan código como punto de partida para crear una solución basada en un documento o un libro. En estos tipos de soluciones, el código se ejecuta sólo cuando el documento asociado se abre en Word o Excel.

    Las plantillas de proyecto Plantilla de Word y Plantilla de Excel se comportan de forma idéntica a las plantillas de proyecto Documento de Word y Libro de Excel. Sin embargo, las plantillas de proyecto Plantilla de Word y Plantilla de Excel simplifican la creación de nuevas copias locales de documentos o libros de la plantilla personalizada en su solución. Las características de su solución están disponibles en el nuevo documento que el usuario crea a partir de la plantilla.

Nota:

Las plantillas de Word que hacen referencia a extensiones de código administrado no se pueden usar como complementos globales de VSTO. No se llama al ensamblado si la plantilla se carga desde el directorio de inicio de Word. Para obtener más información, vea Limitaciones de plantillas globales y complementos de Excel (archivos.xla).

Para obtener información sobre cómo empezar en estos tipos de proyecto, vea los temas siguientes:

Complementos de VSTO

El nodo Office/SharePoint del cuadro de diálogo Nuevo proyecto proporciona las siguientes plantillas de proyecto como punto de partida para crear complementos de VSTO.

Soluciones de documento frente a plantillas

Cuando se diseña una solución basada en un documento de Word o en un libro de Excel, se debe optar por el mejor método para poner el documento a disposición de los usuarios.

Se aplica a: la información de este tema se aplica a proyectos de nivel de documento para Excel y Word. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

En algunas ocasiones, es posible que desee proporcionar una copia de un documento a cada usuario. En este caso, cree la solución utilizando un proyecto de documento de Word o de Excel.

En otras ocasiones, quizá desee colocar una plantilla en un servidor para que cada usuario pueda abrirla (produciéndose de ese modo el evento) y guardar una copia local como un documento. En este caso, cree la solución utilizando un proyecto de plantilla de Word o de Excel.

De comparación

La tabla siguiente resume las diferencias existentes entre documentos y plantillas.

Documentos Templates (Plantillas [C++])
Los usuarios pueden abrir y modificar un documento, salvo que esté configurado como de sólo lectura. Los cambios guardados se mantienen en el original. Los usuarios pueden abrir una plantilla para crear una copia local como documento nuevo. No pueden modificar el original, salvo si tienen permisos especiales.
Cuando se abre, el documento produce el evento Open . Cuando se abre, la plantilla produce el evento New .

Limitaciones de plantillas globales y complementos de Excel (archivos.xla)

Es posible que los documentos, los libros y las plantillas no funcionen correctamente como plantillas globales ni como complementos VSTO de Excel (archivos .xla).

Plantillas de Word

Cuando una plantilla de Microsoft Office Word tiene extensiones de código administradas, no se llama al ensamblado del proyecto si la plantilla se adjunta como plantilla global o se carga desde el directorio de inicio de Word. Además, el documento no reconoce el formato de una plantilla que forma parte de una solución de Office.

Complementos de Excel (archivos.xla)

No hay ningún proyecto de Office para crear un complemento de VSTO de Excel (archivo.xla ). Se pueden guardar libros como archivos .xla, pero no es una operación admitida y no es recomendable hacerlo. Si guarda un libro que tiene extensiones de código administrado como un archivo de complemento de Microsoft Office Excel (*.xla), puede seleccionarlo en el cuadro de diálogo Complementos para aplicar a otro libro. En algunos casos, el código se ejecutará en el libro de destino después de aplicar el complemento VSTO, pero no se admite este uso de la solución de Office.