Compartilhar via


Visão geral do modelo de objeto do Excel

Para desenvolver soluções que usam o Excel de Microsoft Office, você pode interagir com os objetos fornecidos pelo modelo de objeto do Excel. Este tópico apresenta os objetos mais importantes:

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Excel 2007 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

The object model closely follows the user interface. O Application objeto representa o aplicativo inteiro e cada Workbook objeto contém uma coleção de Worksheet objetos. A partir daí, a abstração principal que representa as células é o Range o objeto, que permite trabalhar com células individuais ou grupos de células.

Além do modelo de objeto do Excel, os projetos do Office em Visual Studio fornecem itens do host e controles de host que ampliam a alguns objetos no modelo de objeto do Excel. Itens de host e controles de host que se comportam como eles estendem os objetos do Excel, mas também têm funcionalidades adicionais como, por exemplo, os recursos de ligação de dados e eventos extras. For more information, see Automatizar o Excel usando o Extended objetos and Itens de host e a visão geral sobre controles de Host.

Este tópico fornece uma visão geral sobre o modelo de objeto do Excel. Para obter recursos onde você pode aprender mais sobre todo o modelo de objeto do Excel, consulte usando a documentação de modelo de objeto do Excel.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Fazer como i: Usar os manipuladores de eventos no Excel 2007 suplemento?, e como faço Use as formas para criar um gráfico de bolhas no Excel?.

Acessando objetos em um projeto do Excel

Quando você cria um novo projeto de nível de aplicativo para o Excel, o Visual Studio cria automaticamente um arquivo de código ThisAddIn. vb ou ThisAddIn.cs. Você pode acessar o objeto do aplicativo usando Me.Application ou this.Application.

Quando você cria um novo projeto de nível de documento do Excel, você tem a opção de criar um novo projeto de pasta de trabalho do Excel ou o modelo do Excel. Visual Studio cria automaticamente os arquivos de código a seguir em seu novo projeto do Excel para a pasta de trabalho e o modelo de projetos.

Visual Basic

C#

ThisWorkbook. vb

ThisWorkbook.cs

Sheet1.vb

Sheet1.cs

Sheet2.vb

Sheet2.cs

Sheet3.vb

Sheet3.cs

Você pode usar o Globals a classe em seu projeto para acessar ThisWorkbook, Sheet1, Sheet2, ou Sheet3 de fora da classe. respectivos For more information, see Acesso global a objetos em projetos do Office. O exemplo a seguir chama o PrintPreview o método de Sheet1 independentemente, por exemplo, se o código é colocado em um da Sheetn classes ou o ThisWorkbook classe.

Globals.Sheet1.PrintPreview()
Globals.Sheet1.PrintPreview(missing);

Porque os dados em um documento do Excel altamente estão estruturados, o modelo de objeto é hierárquica e direto. O Excel oferece centenas de objetos com os quais você talvez queira interagir, mas você pode obter um bom começo no modelo de objeto concentrando-se em um subconjunto muito pequeno de objetos disponíveis. Esses objetos incluem as quatro seguintes:

  • Application

  • Pasta de trabalho

  • Planilha

  • Range

Grande parte do trabalho feito com o Excel gira em torno de quatro esses objetos e seus membros.

Objeto de aplicativo

O Excel Application objeto representa o aplicativo do Excel. O Application objeto expõe uma grande quantidade de informações sobre o aplicativo em execução, as opções aplicadas a essa instância, e objetos de usuário atual abrir dentro da instância.

ObservaçãoObservação

Você não deve definir o EnableEvents propriedade da Application objeto no Excel para false. Setting this property to false prevents Excel from raising any events, including the events of host controls.

Objeto Workbook

O Microsoft.Office.Interop.Excel.Workbook objeto representa uma única pasta de trabalho dentro do aplicativo Excel.

As ferramentas de desenvolvimento do Office em Visual Studio estende o Microsoft.Office.Interop.Excel.Workbook o objeto fornecendo a Microsoft.Office.Tools.Excel.Workbook tipo. Esse tipo fornece acesso a todos os recursos de um Microsoft.Office.Interop.Excel.Workbook o objeto, bem como novos recursos, como a capacidade de adicionar marcas inteligentes para uma pasta de trabalho. For more information, see Item de Host da pasta de trabalho.

ObservaçãoObservação

As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010. For more information, see Visão geral sobre marcas inteligentes.

Objeto Worksheet

O Microsoft.Office.Interop.Excel.Worksheet objeto é um membro da Worksheets coleção. Muitas das propriedades, métodos e eventos da Microsoft.Office.Interop.Excel.Worksheet são idênticos ou semelhantes aos membros fornecidos pelo Application ou Microsoft.Office.Interop.Excel.Workbook objetos.

O Excel oferece uma Sheets a coleção como uma propriedade de um Microsoft.Office.Interop.Excel.Workbook objeto. Cada membro da Sheets coleção é um Microsoft.Office.Interop.Excel.Worksheet ou Microsoft.Office.Interop.Excel.Chart objeto.

As ferramentas de desenvolvimento do Office em Visual Studio estende o Microsoft.Office.Interop.Excel.Worksheet o objeto fornecendo a Microsoft.Office.Tools.Excel.Worksheet tipo. Esse tipo fornece acesso a todos os recursos de um Microsoft.Office.Interop.Excel.Worksheet o objeto, bem como novos recursos, como a capacidade de host controles gerenciados e lidar com novos eventos. For more information, see Item de Host de planilha.

Objeto Range

O Microsoft.Office.Interop.Excel.Range é o objeto que você usará mais em seus aplicativos do Excel. Antes que você pode manipular qualquer região dentro do Excel, você deve expressá-la como um Range objeto e trabalhar com os métodos e propriedades do intervalo. A Range de objeto representa uma célula, uma linha, uma coluna, uma seleção de células que contém um ou mais blocos de células (que podem ou não ser contíguas), ou mesmo de um grupo de células em várias folhas.

Visual Studio estende o Microsoft.Office.Interop.Excel.Range o objeto fornecendo a Microsoft.Office.Tools.Excel.NamedRange e Microsoft.Office.Tools.Excel.XmlMappedRange tipos. Esses tipos têm a maioria dos mesmos recursos de um Microsoft.Office.Interop.Excel.Range vinculação de objeto, bem como novos recursos, como os dados de capacidade e novos eventos. For more information, see Controle de NamedRange and Controle de XmlMappedRange.

Usando a documentação de modelo de objeto do Excel

Para obter informações completas sobre o modelo de objeto do Excel, você pode consultar a referência de assembly de interoperabilidade primária (PIA) do Excel e a referência de modelo de objeto do VBA.

Referência de Assembly de interoperabilidade primária

A documentação de referência do Excel PIA descreve os tipos no assembly de interoperabilidade primária do Excel. Esta documentação está disponível a partir do seguinte local: Referência de Assembly de interoperabilidade do Excel 2010 primário.

ObservaçãoObservação

O PIA do Excel 2007 não está documentado neste momento. No entanto, os tipos do PIA do Excel 2007 também estão incluídos no PIA do Excel 2010, para que as informações contidas nesta documentação de referência também se aplica ao Excel 2007.

Para obter mais informações sobre o design de PIA do Excel, como, por exemplo, as diferenças entre as classes e interfaces o PIA e como os eventos em que o PIA são implementados, consulte Visão geral das Classes e Interfaces no Office Primary Interop Assemblies.

Referência de modelo de objeto do VBA

Os VBA objeto modelo documentos de referência o modelo de objeto do Excel como ele é exposto para Visual Basic for Applications o código VBA (). A referência de modelo de objeto do VBA para Excel está disponível nos seguintes locais:

Todos os objetos e membros na referência de modelo de objeto do VBA correspondem a tipos e membros no PIA do Excel. Por exemplo, o Worksheet o objeto na referência de modelo de objeto do VBA corresponde ao Microsoft.Office.Interop.Excel.Worksheet objeto no Excel PIA. Embora a referência de modelo de objeto do VBA fornece exemplos de código para a maioria das propriedades, métodos e eventos, você deve traduzir o código do VBA nesta referência para Visual Basic ou C# Visual se desejar usá-los em um projeto do Excel que você criar usando o Visual Studio.

Title

Description

Como: Criar um modelo do BDC

Explica como criar personalizações em nível de documento e os suplementos de nível de aplicativo para o Excel de Microsoft Office.

Como: Adicionar um arquivo de modelo do BDC existente a um projeto do SharePoint

Fornece exemplos que mostram como executar tarefas comuns de células.

Como: Use para especificar um arquivo de recurso localizado nomes, propriedades e permissões

Fornece exemplos que mostram como executar tarefas comuns com intervalos.

Como: Incluir um Assembly personalizado em um recurso do BDC

Fornece exemplos que mostram como executar tarefas comuns de planilhas.

Trabalhando com pastas de trabalho

Fornece exemplos que mostram como executar tarefas comuns com pastas de trabalho.

Histórico de alterações

Date

History

Motivo

Maio de 2010

Informações atualizadas sobre a documentação de referência de modelo de objeto.

Aprimoramento de informações.