Plantilla de proyecto de plantillas de Word

  • Artículo

Actualización: noviembre 2007

Se aplica a

La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados.

Tipo de proyecto

  • Proyectos de nivel de documento

Versión de Microsoft Office

  • Word 2007

  • Word 2003

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

La plantilla de proyecto para las plantillas de Word en Visual Basic y Visual C# proporciona el marco de trabajo para las soluciones que se basan en plantillas de Microsoft Office Word nuevas o existentes. Hay plantillas de proyecto diferentes para las plantillas de Word 2003 y las plantillas de Word 2007. Las plantillas de proyecto agregan automáticamente las referencias de ensamblado, los archivos y el código generado necesarios para usarlos como punto de inicio de la solución.

Las plantillas de Word que hacen referencia a extensiones de código administrado no se pueden utilizar como complementos globales. 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 las plantillas globales y los complementos de Excel (archivos .xla).

Si se abre una plantilla para editarla fuera de Visual Studio después de haber compilado la solución, la plantilla ejecutará el código como si se hubiera creado un nuevo documento a partir de la plantilla. Dependiendo del código, esto podría modificar la plantilla mientras se abre, antes de empezar a editarla. Para evitar que el código se ejecute, mantenga presionada la tecla MAYÚS mientras se abre la plantilla.

Nota:

De forma predeterminada, algunos de los archivos y referencias de la lista siguiente están ocultos. Para verlos, haga clic en Mostrar todos los archivos en la barra de herramientas del Explorador de soluciones. Además, existen algunos archivos y referencias que no se muestran en la lista siguiente que son comunes a muchas plantillas de proyecto de Visual Studio.

Archivos

Visual Studio Tools para Office genera los siguientes archivos visibles en los proyectos de plantillas de Word 2003 y Word 2007:

  • Nombre de documento.dot: representa la plantilla de Word de un proyecto. Contiene el archivo de código y la superficie de diseño del documento.

  • ThisDocument (archivo .vb para Visual Basic o archivo .cs para Visual C#): un documento que proporciona la superficie de diseño y el archivo de código. Para obtener más información, vea Elemento host Document.

Nota:

No se pueden agregar clases adicionales al código subyacente en un documento, libro u hoja de cálculo. Debe agregar archivos nuevos al proyecto para que éstos contengan las clases que desee escribir.

Visual Studio Tools para Office también crea el siguiente archivo adicional cuando se genera un proyecto de plantilla de Word 2007:

Archivos ocultos

Visual Studio Tools para Office genera varios archivos ocultos. No modifique estos archivos manualmente; se vuelven a generar cuando se realizan cambios en el proyecto y no conservan las modificaciones manuales.

Visual Studio Tools para Office genera los siguientes archivos ocultos:

  • ThisDocument.Designer.xml: una representación declarativa de sólo lectura de los objetos programables del documento.

  • ThisDocument.Designer (archivo .vb o .cs): archivo de código de sólo lectura que proporciona implementaciones auxiliares de los objetos del documento, incluido el código necesario para crear una instancia de los objetos correctamente.

  • Nombre Documento.Designer.xml; representación declarativa de sólo lectura de los objetos programables, como los controles personalizados que, de manera predeterminada, no forman parte de Visual Studio Tools para Office. Este archivo se genera al agregar un control personalizado al documento.

  • Nombre Documento.Designer (archivo .vb o .cs): archivo de código de sólo lectura que proporciona implementaciones auxiliares para controles personalizados. Este archivo se genera al agregar un control personalizado al documento.

Código de plantilla

Los controladores de eventos siguientes se incluyen en los archivos de código de la plantilla de proyecto. Para obtener más información, consulte Eventos de proyectos de Visual Studio Tools para Office.

ThisDocument_Startup

ThisDocument_Startup controla el evento Document.Startup. Este evento se produce cuando la solución está en ejecución y se ha ejecutado todo el código de inicialización del ensamblado. Utilice este controlador de eventos para ejecutar el código que inicializa la solución.

ThisDocument_Shutdown

ThisDocument_Shutdown controla el evento Document.Shutdown. Este evento se produce cuando está a punto de descargarse el dominio de aplicación en el que está cargado el código.

Referencias

Visual Studio Tools para Office crea automáticamente un conjunto de referencias de ensamblado en los proyectos de plantillas de Word. Estas referencias incluyen los siguientes ensamblados:

Vea también

Tareas

Cómo: Crear proyectos de Visual Studio para Office

Conceptos

Información general sobre los ensamblados en las soluciones de Office

Información general acerca del modelo de objetos de Word

Otros recursos

Administrar soluciones, proyectos y archivos

Plantillas de proyecto de Office