Elemento host WorksheetWorksheet host item

El elemento host Worksheet es un tipo que extiende el tipo Worksheet del ensamblado de interoperabilidad primario de Excel.The Worksheet host item is a type that extends the Worksheet type from the primary interop assembly for Excel. Asimismo, el elemento host Worksheet ofrece las mismas propiedades, los mismos métodos y eventos que un objeto Worksheet , pero también expone eventos adicionales y sirve de contenedor para los controles host y para los controles de Windows Forms.The Worksheet host item provides all of the same properties, methods, and events as a Worksheet object, but it also exposes additional events and acts as a container for host controls and Windows Forms controls.

Se aplica a: la información de este tema se aplica al documento-proyectos y agregar de VSTO de nivel-en los proyectos de Excel.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Excel. Para obtener más información, consulte características disponibles por tipo de aplicación y el proyecto de Office.For more information, see Features available by Office application and project type.

En los proyectos de nivel de documento, puede agregar elementos host Worksheet al proyecto en tiempo de diseño.In document-level projects, you can add Worksheet host items to your project at design time. En proyectos de complemento VSTO, puede generar Worksheet hospedar elementos en tiempo de ejecución.In VSTO Add-in projects, you can generate Worksheet host items at runtime.

Comprender los elementos host de hoja de cálculo en proyectos de nivel de documentoUnderstand worksheet host items in document-level projects

Cuando se crea un proyecto de nivel de documento para Excel, Visual Studio crea automáticamente tres elementos host Worksheet en el proyecto.When you create a document-level project for Excel, Visual Studio automatically creates three Worksheet host items in the project. Los nombres predeterminados de las hojas de cálculo son Sheet1, Sheet2y Sheet3.The default names of the worksheets are Sheet1, Sheet2, and 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.If you create a project based on an existing workbook, the number of host items depends on the number of worksheets in the workbook.

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.These worksheet classes give you access to members of the Worksheet host item to perform basic tasks in your customization, such as modifying the contents of a worksheet. También puede utilizar estas clases para agregar controles a hojas de cálculo.You can also use these classes to add controls to worksheets. Si combina diferentes conjuntos de controles y escribe el código, puede enlazar los controles a los datos, recopilar información del usuario y responder a las acciones del usuario.By combining different sets of controls and writing code, you can bind the controls to data, collect information from the user, and respond to user actions. Para obtener más información, consulte programar personalizaciones de nivel de documento.For more information, see Program document-level customizations.

Las clases de hojas de cálculo ofrecen una ubicación en la que puede empezar a escribir código en el proyecto.The worksheet classes provide a location in which you can start writing code in your project. 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.Because the class provides all of the same properties, methods, and events as the Worksheet object in the primary interop assembly for Excel, you can also use these classes to access the object model of Excel. Para obtener más información, consulte información general sobre el modelo de objetos de Excel.For more information, see Excel object model overview.

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.In document-level projects, you can add additional Worksheet host items to the project at design time by adding a new worksheet to the workbook in the designer.

Cambiar el nombre de las hojas de cálculoRename worksheets

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.In a document-level project, you can rename the worksheets in the Visual Studio designer, but this only changes the display name of the worksheet. El nombre de programación sigue siendo el nombre predeterminado de la hoja de cálculo.The programmatic name is still the default name of the worksheet. Si cambia el nombre de la hoja de cálculo en la ventana Propiedades , solo cambia el nombre de programación.If you rename the worksheet in the Properties window, only the programmatic name is changed.

Limitaciones del elemento de host de hoja de cálculo en proyectos de nivel de documentoLimitations of the worksheet host item in document-level projects

No se puede crear de nuevo Worksheet elementos en tiempo de ejecución en un proyecto de nivel de documento host.You cannot create new Worksheet host items at runtime in a document-level project. Si crea una nueva hoja de cálculo de Excel en tiempo de ejecución, será del tipo Worksheet.If you create a new Excel worksheet at runtime, it will be of the type Worksheet. Como no se trata de un elemento host, este no puede contener controles host ni controles de Windows Forms.Because it is not a host item, it cannot contain any host controls or Windows Forms controls. Para obtener más información sobre la creación de documentos en tiempo de ejecución, consulte Cómo: agregar nuevas hojas de cálculo a libros mediante programación.For more information about creating documents at run time, see How to: Programmatically add new worksheets to workbooks.

Comprender los elementos host de hoja de cálculo en proyectos de complemento VSTOUnderstand worksheet host items in VSTO Add-in projects

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.In application-level projects, you can generate a Worksheet host item at run time for any worksheet that is open in 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 .You can use the Worksheet host item to add controls to the associated worksheet, or to handle events that are not available on Worksheet objects.

Para generar un Worksheet elemento host, utilice el GetVstoObject método.To generate a Worksheet host item, use the GetVstoObject method. Para obtener más información, consulte documentos ampliar Word y libros de Excel en complementos VSTO en tiempo de ejecución.For more information, see Extend Word documents and Excel workbooks in VSTO Add-ins at runtime.

Vea tambiénSee also

Tutoriales y ejemplos de desarrollo de office Office development samples and walkthroughs
Extender documentos de Word y libros de Excel en complementos VSTO en tiempo de ejecución Extend Word documents and Excel workbooks in VSTO Add-ins at runtime
Controles en documentos de Office Controls on Office documents
Agregar controles a documentos de Office en tiempo de ejecución Add controls to Office documents at runtime
Elementos host y la información general sobre controles de host Host items and host controls overview
Elemento host Workbook Workbook host item
Automatizar Excel usando objetos extendidos Automate Excel by using extended objects
Limitaciones de programación de elementos host y controles hostProgrammatic limitations of host items and host controls