Visão geral sobre o modelo de objeto do Excel

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

• Microsoft.Office.Interop.Excel.Application

• Microsoft.Office.Interop.Excel.Workbook

• Microsoft.Office.Interop.Excel.Worksheet

• Microsoft.Office.Interop.Excel.Range

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 2013 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

O modelo de objeto maneira compatível com a interface do usuário.O objeto de Application representa o aplicativo inteiro, e cada objeto de Workbook contém uma coleção de objetos de Worksheet .De aí, abstração principal que representa células é o objeto de Range , que permite que você trabalhe com células individuais ou grupos de células.

Além do modelo de objeto do excel, os projetos do Office no Visual Studio oferecem itens host e hospedarem controles que estendem alguns objetos no modelo de objeto do excel.Os itens host e controles host se comportam como os objetos que estendem o excel, mas também possuem funcionalidades adicionais como recursos de associação de dados e eventos adicionais.Para obter mais informações, consulte Automatizar o Excel usando o Extended objetos e Itens de host e visão geral sobre controles de Host.

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

Para uma demonstração de vídeo relacionada, consulte Como: eu faço Use manipuladores de eventos em um suplemento ao Excel 2007?, e Como: eu faço Use formas para criar um gráfico de bolhas do excel?.

Acessando objetos em um projeto do excel

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

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

Você pode usar a classe de Globals em seu projeto acessar ThisWorkbook, Sheet1, Sheet2, ou Sheet3 fora da classe respectiva.Para obter mais informações, consulte Acesso global a objetos em projetos do Office.O exemplo a seguir chama o método de PrintPreview de Sheet1 independentemente de se o código é colocado em uma das classes de Sheetem ou da classe de ThisWorkbook .

Globals.Sheet1.PrintPreview()

Globals.Sheet1.PrintPreview();

Como os dados em um documento do excel são estruturados altamente, o modelo de objeto é hierárquica e simples.O excel fornece centenas de objetos COM que você pode querer interagir, mas você pode obter um bom início no modelo de objeto se centrando sobre um subconjunto muito pequeno de objetos disponíveis.Esses quatro objetos incluem os seguintes:

• Application

• pasta de trabalho

• planilha

• Intervalo

Muito de trabalho feito com centros do excel em torno de esses quatro objetos e seus membros.

Objeto de aplicativo

O objeto do excel Application representa o próprio aplicativo do excel.O objeto expõe de Application mais informações sobre o aplicativo em execução, as opções aplicadas a essa instância, e objetos do usuário atual abre dentro da instância.

Observação
Você não deve definir a propriedade de EnableEvents do objeto de Application Excel a false.Defina essa propriedade como false impede que o excel para aumentar todos os eventos, incluindo os eventos de controles host.

Objeto de pasta de trabalho

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

Ferramentas de desenvolvimento do Office no Visual Studio estendem o objeto de Microsoft.Office.Interop.Excel.Workbook fornecendo o tipo de Microsoft.Office.Tools.Excel.Workbook .Este tipo fornece acesso a todos os recursos de um objeto de Microsoft.Office.Interop.Excel.Workbook .Para obter mais informações, consulte Item de Host da pasta de trabalho.

Objeto da planilha

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

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

Ferramentas de desenvolvimento do Office no Visual Studio estendem o objeto de Microsoft.Office.Interop.Excel.Worksheet fornecendo o tipo de Microsoft.Office.Tools.Excel.Worksheet .Este tipo fornece à ele o acesso a todos os recursos de um objeto de Microsoft.Office.Interop.Excel.Worksheet , bem como a novos recursos como a capacidade para hospedar controles gerenciados e tratar novos eventos.Para obter mais informações, consulte Item de Host de planilha.

Objeto do intervalo

O objeto de Microsoft.Office.Interop.Excel.Range é o objeto que você usará na maioria dos aplicativos de excel.Antes que você pode manipular toda a região no excel, você deve expressá-la como um objeto de Range e trabalhar com métodos e propriedades de esse intervalo.Um objeto de Range representa uma célula, uma linha, uma coluna, uma seleção das células que contém um ou vários blocos de células, que podem ou não podem ser contíguos, ou até mesmo um grupo de células em várias folhas.

O Visual Studio estende o objeto de Microsoft.Office.Interop.Excel.Range fornecendo os tipos de Microsoft.Office.Tools.Excel.NamedRange e de Microsoft.Office.Tools.Excel.XmlMappedRange .Esses tipos têm a maioria dos mesmos recursos de um objeto de Microsoft.Office.Interop.Excel.Range , bem como novos recursos como o recurso de associação de dados e novos eventos.Para obter mais informações, consulte Controle NamedRange e Controle de XmlMappedRange.

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

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

Referência do assembly de Interoperabilidade primária

Documentação de referência de PIA descreve os tipos do excel no assembly de interoperabilidade primária para o excel.Esta documentação está disponível no seguinte local: Referência do assembly principal do Excel 2010 Interoperabilidade.

Para obter mais informações sobre o design de PIA Excel, como as diferenças entre classes e interfaces no PIA e como eventos no PIA são implementados, consulte Visão geral das classes e interfaces em assemblies de Interoperabilidade primários Office.

Referência de modelos de objeto de VBA

Documentos de referência de modelos de objeto de VBA o modelo de objeto do excel como ele é exposto ao código do Visual Basic é VBA Applications ().Para obter mais informações, consulte Referência de modelos de objeto do Excel 2010.

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

Tópicos relacionados