Elemento host de hoja de cálculo

  • Artículo

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

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

Descripción de los elementos host de la 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, Sheet2y Sheet3. Si crea un proyecto basado en un libro existente, el número de elementos host depende del número de hojas de cálculo del libro.

Estas clases de hojas de cálculo ofrecen acceso a los miembros del elemento host Worksheet para realizar tareas básicas en la personalización, como modificar el contenido de una hoja de cálculo. También puede utilizar estas clases para agregar controles a hojas de cálculo. Si combina diferentes conjuntos de controles y escribe código, puede enlazar los controles a los datos, recopilar información del usuario y responder a las acciones del usuario. Para obtener más información, consulte Personalizaciones de nivel de documento del programa.

Las clases de hojas de cálculo ofrecen una ubicación en la que puede empezar a escribir código en el proyecto. Como esta clase proporciona las mismas propiedades, métodos y eventos que el objeto Worksheet que se encuentra en el ensamblado de interoperabilidad primario de Excel, también puede usar 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 los proyectos de nivel de documento, puede agregar más elementos host Worksheet al proyecto en tiempo de diseño si agrega una nueva hoja de cálculo al libro en el diseñador.

Cambiar el nombre de hojas de cálculo

En un proyecto de nivel de documento, puede cambiar el nombre de las hojas de cálculo en el diseñador de Visual Studio, pero esto solo 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 cambia el nombre de programación.

Limitaciones del elemento host de hoja de cálculo en proyectos de nivel de documento

No es posible crear nuevos elementos host Worksheet en tiempo de ejecución en un proyecto de nivel de documento. Si crea una nueva hoja de cálculo de Excel en tiempo de ejecución, será del tipo Worksheet. 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 documentos en tiempo de ejecución, vea How to: Programmatically add new worksheets to workbooks (Cómo: Agregar nuevas hojas de cálculo mediante programación a libros).

Descripción de los elementos host de la hoja de cálculo en proyectos de complemento de VSTO

En los proyectos de nivel de aplicación, puede generar un elemento host Worksheet en tiempo de ejecución para cualquier hoja de cálculo que esté abierta en Excel. Puede usar el elemento host Worksheet para agregar controles a la hoja de cálculo asociada o para administrar los eventos que no estén disponibles en los objetos Worksheet .

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

Contenido relacionado