Plantilla de proyecto de plantillas de Word

Actualización: noviembre 2007

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:

• Nombre Proyecto_TemporaryKey.pfx: certificado temporal que se puede usar para firmar los manifiestos de aplicación e implementación del proyecto durante la fase de desarrollo. Para obtener más información, consulte Otorgar confianza a las soluciones de Office (2007 System) y Seguridad en las soluciones de Office (2007 System).

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:

• Los ensamblados en el motor en tiempo de ejecución de Visual Studio Tools para Office. Para obtener más información sobre estos ensamblados, vea Información general sobre el motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

• Los ensamblados de interoperabilidad primarios para los componentes compartidos de Microsoft Office y para Word. Para obtener más información, consulte Ensamblados de interoperabilidad primarios de Office.

• Los ensamblados de .NET Framework que se utilizan al desarrollar soluciones de Visual Studio Tools para Office.

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