Compartir a través de

Introducción al modelo de objetos de Excel

  • Artículo

Para desarrollar soluciones que usen Microsoft Office Excel, puede interactuar con los objetos proporcionados por el modelo de objetos de Excel. Este tema presenta los objetos más importantes:

Nota:

¿Le interesa desarrollar soluciones que amplíen la experiencia de Office en varias plataformas? Consulte el nuevo modelo de complementos de Office. Los complementos de Office tienen una superficie pequeña en comparación con los complementos y soluciones de VSTO, y puede compilarlos mediante casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.

El modelo de objetos está estrechamente relacionado con la interfaz de usuario. El objeto Application representa toda la aplicación, y cada objeto Workbook contiene una colección de objetos Worksheet. A partir de ahí, la principal abstracción que representa celdas es el objeto Range, que permite trabajar con celdas individuales o grupos de celdas.

Además del modelo de objetos de Excel, los proyectos de Office de Visual Studio proporcionan elementos host y controles host que extienden algunos objetos en el modelo de objetos de Excel. Los elementos y controles host se comportan como los objetos de Excel que extienden, pero tienen también una funcionalidad adicional, como capacidades de enlace de datos y eventos adicionales. Para obtener más información, consulte Automatización de Excel mediante objetos extendidos y información general sobre elementos host y controles host.

En este tema se proporciona una breve introducción del modelo de objetos de Excel. Para obtener más información sobre todo el modelo de objetos de Excel, consulte Uso de la documentación del modelo de objetos de Excel.

Obtener acceso a objetos en un proyecto de Excel

Al crear un nuevo proyecto de complemento de VSTO para Excel, Visual Studio crea automáticamente un archivo de código ThisAddIn.vb o ThisAddIn.cs . Puede obtener acceso al objeto Application mediante Me.Application o this.Application.

Cuando se crea un nuevo proyecto de nivel de documento para Excel, tiene la opción de crear un nuevo proyecto de libro de Excel o plantilla de Excel. Visual Studio crea automáticamente los siguientes archivos de código en los nuevos proyectos de Excel, tanto de libro como de plantilla.

Visual Basic C#
ThisWorkbook.vb ThisWorkbook.cs
Sheet1.vb Sheet1.cs
Sheet2.vb Sheet2.cs
Sheet3.vb Sheet3.cs

Puede utilizar la clase Globals en el proyecto para tener acceso a ThisWorkbook, Sheet1, Sheet2 o Sheet3 desde fuera de la clase correspondiente. Para obtener más información, vea Acceso global a objetos en proyectos de Office. En el ejemplo siguiente se llama al PrintPreview método de Sheet1 independientemente de si el código se coloca en una de lasSheet n clases o en la ThisWorkbook clase .

Globals.Sheet1.PrintPreview();

Puesto que los datos de un documento de Excel están muy estructurados, el modelo de objetos es jerárquico y sencillo. Excel proporciona cientos de objetos con los que es posible que quiera interactuar, pero puede empezar bien en el modelo de objetos centrándose en un pequeño subconjunto de los objetos disponibles. Entre estos objetos están los cuatro siguientes:

  • Aplicación

  • Libro

  • Hoja de cálculo

  • Range

    Gran parte del trabajo realizado con Excel se centra en estos cuatro objetos y sus miembros.

Objeto de aplicación

El objeto Application de Excel representa la propia aplicación Excel. El objeto Application expone una gran cantidad de información acerca de la aplicación en ejecución, las opciones que se aplican a esa instancia y los objetos del usuario actual que se abren en la instancia.

Nota:

No debería establecer la propiedad EnableEvents del objeto Application en Excel como false. Al establecer esta propiedad como false, impide que Excel active cualquier evento, incluidos los eventos de los controles host.

Workbook (objeto)

El objeto Workbook representa un único libro dentro de la aplicación Excel.

Las herramientas de desarrollo de Office en Visual Studio extienden el objeto Workbook proporcionando el tipo Workbook . Este tipo da acceso a todas las características de un objeto Workbook. Para obtener más información, vea Elemento host del libro.

Worksheet (objeto)

El objeto Worksheet es miembro de la colección Worksheets. Muchas de las propiedades, métodos y eventos de Worksheet son idénticos o similares a los miembros proporcionados por los objetos Application o Workbook.

Excel proporciona una colección Sheets como propiedad de un objeto Workbook. Cada miembro de la colección Sheets es un objeto Worksheet o Chart.

Las herramientas de desarrollo de Office en Visual Studio extienden el objeto Worksheet proporcionando el tipo Worksheet . Este tipo da acceso a todas las características de un objeto Worksheet y a nuevas características como la capacidad de hospedar controles administrados y de controlar nuevos eventos. Para obtener más información, vea Elemento host de hoja de cálculo.

Range (objeto)

El objeto Range es el objeto que más utilizará en las aplicaciones de Excel. Para poder manipular una región de Excel, debe expresarla como un objeto Range y trabajar con métodos y propiedades de ese intervalo. Un objeto Range representa una celda, una fila, una columna, una selección de celdas que contiene uno o más bloques de celdas (que podrían o no ser contiguas) o incluso un grupo de celdas de varias hojas.

Visual Studio extiende el objeto Range proporcionando los tipos NamedRange y XmlMappedRange. Estos tipos tienen la mayoría de las características de un objeto Range, además de nuevas características como la capacidad de enlace de datos y nuevos eventos. Para obtener más información, vea Control NamedRange y Control XmlMappedRange.

Uso de la documentación del modelo de objetos de Excel

Para obtener información completa sobre el modelo de objetos de Excel, puede consultar la referencia del ensamblado de interoperabilidad primario (PIA) de Excel y la referencia del modelo de objetos VBA.

Referencia del ensamblado de interoperabilidad principal

La documentación de referencia de los PIA de Excel describe los tipos Del ensamblado de interoperabilidad primario para Excel. Esta documentación está disponible en la siguiente ubicación: Referencia de ensamblado de interoperabilidad principal de Excel 2010.

Para obtener más información sobre el diseño del PIA de Excel, como las diferencias entre clases e interfaces en el PIA y cómo se implementan los eventos del PIA, vea Información general de las clases e interfaces en los ensamblados de interoperabilidad primarios de Office.

Referencia del modelo de objetos de VBA

La referencia del modelo de objetos de VBA documenta el modelo de objetos de Excel tal como se expone al código de Visual Basic para Aplicaciones (VBA). Para obtener más información, vea Referencia del modelo de objetos de Excel 2010.

Todos los objetos y miembros de la referencia del modelo de objetos de VBA corresponden a tipos y miembros del PIA de Excel. Por ejemplo, el objeto Worksheet de la referencia del modelo de objetos VBA corresponde al Worksheet objeto del PIA de Excel. Aunque la referencia del modelo de objetos VBA proporciona ejemplos de código para la mayoría de las propiedades, métodos y eventos, debe traducir el código VBA de esta referencia a Visual Basic o Visual C# si quiere usarlo en un proyecto de Excel creado con Visual Studio.

Title Descripción
Soluciones de Excel Explica cómo crear personalizaciones de nivel de documento y complementos de VSTO para Microsoft Office Excel.
Trabajar con rangos Proporciona ejemplos que muestran cómo realizar tareas habituales con rangos.
Trabajar con hojas de cálculo Proporciona ejemplos que muestran cómo realizar tareas habituales con hojas de cálculo.
Trabajar con libros Proporciona ejemplos que muestran cómo realizar tareas habituales con libros.