Compartir a través de

Elemento host del libro de Excel

El Workbook elemento host es un tipo que extiende el tipo Workbook del ensamblado de interoperabilidad principal para Excel. El Workbook elemento host proporciona todas las mismas propiedades, métodos y eventos que un Workbook objeto, pero también proporciona 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, vea Características disponibles por aplicación de Office y tipo de proyecto.

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

Comprende el elemento host del libro de trabajo en proyectos a nivel de documento

Para acceder al libro de trabajo en su proyecto, use la clase ThisWorkbook. La clase ThisWorkbook proporciona acceso a los miembros del elemento anfitrión Workbook para realizar tareas básicas en su personalización, como ejecutar código cuando se abre o se cierra el libro de trabajo. Para obtener más información, consulte Personalizaciones de nivel de documento del programa.

La ThisWorkbook clase proporciona una ubicación en la que puede empezar a escribir código en el proyecto. Dado que la clase proporciona todas las mismas propiedades, métodos y eventos que el Workbook objeto en el ensamblado de interoperabilidad principal para Excel, también puede usar ThisWorkbook para tener 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 de libros y para ver las propiedades y eventos del libro en la ventana Propiedades .

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

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

Si crea un nuevo libro de Excel en tiempo de ejecución, será del tipo Workbook. Dado que no es un elemento host, no puede contener ningún control 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 Workbook elemento host no actúa como contenedor para los controles host. Por lo tanto, no puede agregar ningún control visible al libro, pero puede agregar componentes, como DataSet, para que los componentes puedan compartirse con 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 Componente , 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.

Comprender los elementos host del libro de trabajo en proyectos de complemento de VSTO

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

Contenido relacionado

  • Last updated on