Plantilla de proyecto de plantillas de Excel

Actualización: noviembre 2007

La plantilla de proyecto para las plantillas de Excel en Visual Basic y Visual C# proporciona el marco de trabajo para las soluciones que se basan en plantillas de Microsoft Office Excel nuevas o existentes. Hay plantillas de proyecto diferentes para las plantillas de Excel 2003 y Excel 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.

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 de proyectos de plantillas de Excel 2003 y Excel 2007:

• Nombre Libro.xls: representa el libro de Excel del proyecto. Contiene todas las hojas de cálculo y gráficos.

• Sheet1 (archivo .vb para Visual Basic o archivo .cs para Visual C#): una hoja de cálculo que proporciona la superficie de diseño y el código para la primera hoja de cálculo del libro. Para obtener más información, vea Elemento host Worksheet.

• Sheet2 (archivo .vb para Visual Basic o archivo .cs para Visual C#): una hoja de cálculo que proporciona la superficie de diseño y el código para la segunda hoja de cálculo del libro.

• Sheet3 (archivo .vb para Visual Basic o archivo .cs para Visual C#): una hoja de cálculo que proporciona la superficie de diseño y el código para la tercera hoja de cálculo del libro.

• ThisWorkbook (archivo .vb para Visual Basic o archivo .cs para Visual C#): contiene la superficie de diseño y el código para las personalizaciones de libros. Para obtener más información, vea Elemento host Workbook.

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 genera el siguiente archivo adicional cuando se genera un proyecto de plantilla de Excel 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:

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

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

• Sheetn.Designer.xml: representación declarativa de sólo lectura de los objetos programables de la hoja de cálculo.

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

• Nombre Libro.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 a una hoja de cálculo del libro.

• Nombre Libro.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 a una hoja de cálculo del libro.

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.

Controladores de eventos de inicio

Estos controladores de eventos controlan los eventos Workbook.Startup y Worksheet.Startup. Estos eventos se producen en cada uno de las hojas de cálculo y en el libro una vez que la solución se encuentra en ejecución y se ha ejecutado todo el código de inicialización del ensamblado. Utilice estos controladores de eventos para ejecutar el código que inicializa la solución.

Las llamadas a los controladores de eventos de Startup en una solución de plantillas se producen en este orden:

1. ThisWorkbook_Startup.

2. Sheet1_Startup.

3. Sheet2_Startup.

4. Sheet3_Startup.

5. El resto de hojas en orden.

El orden se determina cuando se compila el proyecto. Si el usuario reorganiza las hojas en tiempo de ejecución, no cambia el orden en que se producen los eventos cuando se abre el libro de nuevo.

Controladores de eventos de cierre

Estos controladores de eventos controlan los eventos Workbook.Shutdown y Worksheet.Shutdown. Estos eventos se producen en cada una de las hojas de cálculo y el libro cuando el dominio de aplicación en que está cargado el código está a punto de descargarse.

Las llamadas a los controladores de eventos de Shutdown en una solución de plantillas se producen en este orden:

1. ThisWorkbook_Shutdown.

2. Sheet1_Shutdown.

3. Sheet2_Shutdown.

4. Sheet3_Shutdown.

5. El resto de hojas en orden.

Referencias

Visual Studio Tools para Office crea automáticamente un conjunto de referencias de ensamblado en los proyectos de plantillas de Excel. 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 de Microsoft Office y para Excel. 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

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

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

Información general sobre el modelo de objetos de Excel

Otros recursos

Administrar soluciones, proyectos y archivos

Plantillas de proyecto de Office