Elemento host Workbook
El elemento host Workbook es un tipo que extiende el tipo Microsoft.Office.Interop.Excel.Workbook del ensamblado de interoperabilidad primario para Excel. El elemento host Workbook proporciona las mismas propiedades, métodos y eventos que un objeto Microsoft.Office.Interop.Excel.Workbook, pero además proporciona características adicionales.
Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Excel 2007 y Excel 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.
En los proyectos de nivel de documento, hay un elemento host Workbook predeterminado que representa el libro en el proyecto. En los proyectos de nivel de aplicación, se pueden generar elementos host Workbook en tiempo de ejecución.
Introducción al elemento host Workbook en los proyectos de nivel de documento
Para obtener acceso al libro del proyecto, utilice la clase ThisWorkbook. La clase ThisWorkbook le da acceso a los miembros del elemento host Workbook para realizar las tareas básicas de la personalización, por ejemplo, ejecutar código cuando el libro se abre o se cierra. Para obtener más información, vea Programar personalizaciones de nivel de documento.
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 Microsoft.Office.Interop.Excel.Workbook en el ensamblado de interoperabilidad primario para Excel, también puede utilizar 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 del proyecto ThisWorkbook en el Explorador de soluciones para mostrar el diseñador del libro y ver las propiedades y eventos del libro en la ventana Propiedades.
Limitaciones del elemento host Workbook en los 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 en el nivel del documento.
Si se crea un nuevo libro de Excel en tiempo de ejecución, será del tipo Microsoft.Office.Interop.Excel.Workbook. Como no se trata de un elemento host, no puede contener controles host ni controles de formularios Windows Forms. Para obtener más información sobre cómo crear libros en tiempo de ejecución, vea Cómo: Crear nuevos libros.
El elemento host Workbook no actúa como un contenedor para los controles host. Por consiguiente, no puede agregar ningún control visible al libro, pero puede agregar los componentes, como DataSet, para que todas las hojas de cálculo puedan compartirlos. En un proyecto en el nivel del documento, los componentes disponibles para el libro se pueden buscar en la ficha Componente, ficha Datos y ficha Todos los formularios Windows Forms del Cuadro de herramientas.
Nota
Las herramientas de desarrollo de Office en Visual Studio no admiten libros compartidos.
Introducción a los elementos host Workbook en los proyectos de nivel de aplicación
En los proyectos de nivel de aplicación, se puede generar en tiempo de ejecución un elemento host Workbook para cualquier libro que esté abierto en Excel. Para generar un elemento host Workbook, utilice el método GetVstoObject. Para obtener más información, vea Ampliar documentos de Word y libros de Excel en complementos en el nivel de la aplicación en tiempo de ejecución.
Vea también
Conceptos
Información general sobre elementos y controles Host
Automatizar Excel usando objetos extendidos
Limitaciones de programación de elementos y controles Host