Elemento host Worksheet

Artículo
08/10/2011

El elemento host Worksheet es un tipo que extiende el tipo Microsoft.Office.Interop.Excel.Worksheet del ensamblado de interoperabilidad primario para Excel. El elemento host Worksheet proporciona las mismas propiedades, métodos y eventos que un objeto Microsoft.Office.Interop.Excel.Worksheet, pero también expone eventos adicionales y sirve de contenedor para los controles host y controles de Windows Forms.

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, se pueden agregar elementos host Worksheet al proyecto en tiempo de diseño. En los proyectos de nivel de aplicación, se pueden generar elementos host Worksheet en tiempo de ejecución.

Introducción a los elementos host de una hoja de cálculo en proyectos de nivel de documento

Cuando se crea un proyecto de nivel de documento para Excel, Visual Studio crea automáticamente tres elementos host Worksheet en el proyecto. Los nombres predeterminados de las hojas de cálculo son Sheet1, Sheet2 y Sheet3. Si se crea un proyecto basado en un libro existente, el número de elementos host depende del número de hojas de cálculo en el libro.

Estas clases de hoja de cálculo dan acceso a los miembros del elemento host Worksheet para realizar las tareas básicas de la personalización, como modificar el contenido de una hoja de cálculo. También se pueden usar estas clases para agregar controles y etiquetas inteligentes a las hojas de cálculo. Si combina diferentes conjuntos de controles y escribe código, puede enlazar los controles a datos, recopilar información del usuario y responder a acciones del usuario. Para obtener más información, vea Programar personalizaciones de nivel de documento.

Nota

Las etiquetas inteligentes están desusadas en Excel 2010 y Word 2010. Para obtener más información, vea Información general sobre etiquetas inteligentes.

Las clases de hoja de cálculo proporcionan una ubicación en la que puede empezar a escribir el código del proyecto. Como la clase proporciona las mismas propiedades, métodos y eventos que el objeto Microsoft.Office.Interop.Excel.Worksheet en el ensamblado de interoperabilidad primario para Excel, también se pueden utilizar estas clases 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.

En proyectos de nivel de documento, se pueden agregar en tiempo de diseño elementos host Worksheet adicionales al proyecto agregando una nueva hoja de cálculo al libro en el diseñador.

Cambiar el nombre de las hojas de cálculo

En un proyecto de nivel de documento, se puede cambiar el nombre de las hojas de cálculo en el diseñador de Visual Studio, pero esto únicamente cambia el nombre para mostrar de la hoja de cálculo. El nombre de programación sigue siendo el nombre predeterminado de la hoja de cálculo. Si cambia el nombre de la hoja de cálculo en la ventana Propiedades, solo se cambia el nombre de programación.

Limitaciones del elemento host Worksheet en los proyectos de nivel de documento

En tiempo de ejecución, no se pueden crear nuevos elementos host Worksheet en un proyecto de nivel de documento. Si se crea un nuevo documento de Excel en tiempo de ejecución, será del tipo Microsoft.Office.Interop.Excel.Worksheet. 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 documentos en tiempo de ejecución, vea Cómo: Agregar nuevas hojas de cálculo a los libros.

Introducción a los elementos host Worksheet 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 Worksheet para cualquier hoja de cálculo que esté abierta en Excel. Se puede utilizar el elemento host Worksheet para agregar controles y etiquetas inteligentes a la hoja de cálculo asociada o controlar los eventos que no están disponibles en los objetos Microsoft.Office.Interop.Excel.Worksheet.

Para generar un elemento host Worksheet, 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.