Compartir a través de


Elemento host del libro

El elemento host Workbook es un tipo que extiende el tipo Workbook del ensamblado de interoperabilidad primario de Excel. El elemento host Workbook proporciona todas las mismas propiedades, los mismos métodos y eventos que un objeto Workbook , pero también ofrece características adicionales.

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

En proyectos de nivel de documento, existe un elemento host Workbook predeterminado que representa el libro del proyecto. En los proyectos de complemento de VSTO, puede generar elementos host Workbook en tiempo de ejecución.

Descripción del elemento host del libro en proyectos de nivel de documento

Para acceder al documento del proyecto, utilice la clase ThisWorkbook . La clase ThisWorkbook le da acceso a los miembros del elemento host Workbook para que pueda realizar tareas básicas durante la personalización, como por ejemplo, ejecutar el código cuando se abra o se cierre el libro. Para obtener más información, consulte Personalizaciones de nivel de documento del programa.

La clase ThisWorkbook proporciona una ubicación en la que puede empezar a escribir el código del proyecto. Como esta clase proporciona las mismas propiedades, métodos y eventos que el objeto Workbook que se encuentra en el ensamblado de interoperabilidad primario de Excel, también puede usar ThisWorkbook para obtener acceso al modelo de objetos de Excel. Para obtener más información, vea Información general sobre el modelo de objetos de Excel.

Haga doble clic en el elemento de proyecto ThisWorkbook en el Explorador de soluciones para mostrar el diseñador del libro y ver las propiedades y los eventos del libro en la ventana Propiedades .

Limitaciones del elemento host del libro en proyectos de nivel de documento

Un proyecto de nivel de documento puede contener solamente un elemento host Workbook (es decir, la clase ThisWorkbook ). No puede agregar nuevos elementos host Workbook al proyecto en tiempo de diseño ni tampoco crear nuevos elementos host Workbook en tiempo de ejecución desde una personalización de nivel de documento.

Si crea un nuevo libro de Excel en tiempo de ejecución, será del tipo Workbook. Como no se trata de un elemento host, este no puede contener controles host ni controles de Windows Forms. Para obtener más información sobre cómo crear libros en tiempo de ejecución, vea How to: Programmatically create new workbooks(Cómo: Crear libros nuevos mediante programación).

El elemento host Workbook no actúa como un contenedor para los controles host. Por lo tanto, no es posible agregar ningún control visible al libro, pero puede agregar componentes, como un elemento DataSet, de modo que los componentes puedan compartirse en todas las hojas de cálculo. En un proyecto de nivel de documento, los componentes disponibles para el libro se pueden encontrar en la pestaña Componentes , en la pestaña Datos y la pestaña Todos los formularios Windows Forms del Cuadro de herramientas.

Nota:

Las herramientas de desarrollo de Office en Visual Studio no admiten libros compartidos.

Descripción de los elementos host del libro en proyectos de complemento de VSTO

En los proyectos de complemento de VSTO, puede generar un elemento host Workbook en tiempo de ejecución para cualquier libro que esté abierto en Excel. Para generar un elemento host Workbook, use el método GetVstoObject. Para obtener más información, vea Extender documentos de Word y libros de Excel en complementos de VSTO en tiempo de ejecución.