Compartir a través de

Elemento de hoja de cálculo anfitrión

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

En los proyectos de nivel de documento, puede agregar Worksheet elementos de host al proyecto durante el tiempo de diseño. En los proyectos de complemento de VSTO, puede generar Worksheet elementos host en tiempo de ejecución.

Comprender los elementos host de la hoja de cálculo en proyectos a nivel de documento

Al crear un proyecto de nivel de documento para Excel, Visual Studio crea automáticamente tres Worksheet elementos host 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 hoja de cálculo proporcionan acceso a los miembros del Worksheet elemento host para realizar tareas básicas en la personalización, como modificar el contenido de una hoja de cálculo. También puede usar estas clases para agregar controles a hojas de cálculo. Al combinar diferentes conjuntos de controles y escribir 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 hoja de cálculo proporcionan 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 Worksheet objeto en el ensamblado de interoperabilidad principal para Excel, también puede usar estas clases 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.

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

Cambiar el nombre de hojas de cálculo

En un proyecto a 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 visible 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 de hoja de cálculo en proyectos de nivel de documento

No se pueden crear nuevos Worksheet elementos host 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. 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 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 Worksheet elemento host en tiempo de ejecución para cualquier hoja de cálculo que esté abierta en Excel. Puede usar el Worksheet elemento host para agregar controles a la hoja de cálculo asociada o para controlar eventos que no están disponibles en Worksheet los objetos.

Para generar un Worksheet 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