Visão geral do modelo de objeto do Excel

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Projetos de nível de aplicativo Versão do Microsoft Office O Excel 2003 O Excel 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de documento
Projetos de nível de aplicativo

Versão do Microsoft Office

O Excel 2003
O Excel 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

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

O modelo de objeto perto segue a interface do usuário.O objeto Application representa o aplicativo inteiro, e cada objeto Workbook contém uma coleção de objetos de Worksheet.A partir daí, a abstração principal que representa as células é o objeto de Range, que permite que você trabalhar com células individuais ou grupos de células.

Ferramentas do Visual Studio para o Office estende muitos desses objetos nativos para itens de host e controles de host que podem ser usados em personalizações em nível de documento.Esses controles têm funcionalidade adicional, incluindo recursos e eventos de ligação de dados.Por exemplo, um objeto de Microsoft.Office.Interop.Excel.Range nativo do Excel será estendido em um Controlarar de Microsoft.Office.Tools.Excel.NamedRange, que podem ser Ligados a dados e que expõe eventos.Para obter mais informações sobre itens de host e controles de host, consulte objetos de estendido no nível de documento projetos.

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

Acessar objetos em um projeto do Excel

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

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

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

Você pode usar a classe global, Globals, para acessar ThisWorkbook, Sheet1, Sheet2ou Sheet3 de fora da respectiva classe.For more information, see Global Acessar a objetos no Visual Studio Tools para projetos do Office.O exemplo a seguir chama o método PrintPreviewSheet1 independentemente se o código é colocado na classe de Sheet ou a classe Workbook.

Globals.Sheet1.PrintPreview()

Globals.Sheet1.PrintPreview(missing);

Porque os dados em um documento de Excel é altamente estruturados, o modelo de objeto é hierárquica e simples.O Excel oferece centenas de objetos com o qual você pode deseja interagir, mas você pode obter uma boa Iniciar no modelo de objeto, concentrando-se em um muito pequeno subconjunto dos objetos disponíveis.Esses objetos Incluir as seguintes quatro:

Application
Pasta de trabalho
Planilha
Intervalo

Grande parte do trabalho feito com o Excel centros em torno de quatro essas classes e seus membros.

Objeto de aplicativo

O objeto de Application Excel representa o aplicativo Excel propriamente dito.O objeto Application expõe uma grande quantidade de informações sobre o aplicativo Executando, as opções aplicadas a essa instância e os objetos de usuáriatual Abrir dentro da instância do.

Observação:
Você deve Não Definido o EnableEvents propriedade do objeto Application no Excel para false.Configuração esta propriedade como false impede que o Excel disparar os eventos, inclusive os eventos de controles host.

Objeto de pasta de trabalho

A Microsoft.Office.Interop.Excel.Workbook classe representa um Simples pasta de trabalho dentro do aplicativo do Excel.

Ferramentas do Visual Studio para o Office estende a classe de Microsoft.Office.Interop.Excel.Workbook , fornecendo a classe de Microsoft.Office.Tools.Excel.Workbook , que fornece Acessar a Tudo membros da coleção Workbooks, bem como recursos de ligação de dados e os eventos adicionais.

Objeto de planilha

O objeto Microsoft.Office.Interop.Excel.Worksheet é um membro da coleção Worksheets.Muitos da propriedades, métodos e eventos do Microsoft.Office.Interop.Excel.Worksheet são idênticos ou semelhantes às fornecidas pelo Application ou Microsoft.Office.Interop.Excel.Workbook classes de membros.

O Excel fornece uma coleção de Sheets como uma propriedade de um objeto de Microsoft.Office.Interop.Excel.Workbook , mas não há nenhuma classe Sheet no Excel.Em vez disso, cada membro da coleção Sheets é uma Microsoft.Office.Interop.Excel.Worksheet ou um objeto Microsoft.Office.Interop.Excel.Chart.

Para uma personalização de nível de documento, Ferramentas do Visual Studio para o Office fornece um item de host Microsoft.Office.Tools.Excel.Worksheet e cria três instâncias em novos projetos: Sheet1, Sheet2, and Sheet3.Acessar a nenhuma das folhas pode ser feito por meio a referência de Globals.Ferramentas do Visual Studio para o Office estende o objeto de Microsoft.Office.Interop.Excel.Worksheet , fornecendo o item de host Microsoft.Office.Tools.Excel.Worksheet.

Objeto de intervalo

O objeto Microsoft.Office.Interop.Excel.Range é o objeto que você usará mais em seus aplicativos de Excel.Antes de você pode manipular qualquer região dentro do Excel, você deve expressá-lo como um objeto de Range e trabalhar com métodos e propriedades desse intervalo.Um Range 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 podem ser contíguo) ou até mesmo um AAgruparar de células em Múltiplo folhas.

Para uma personalização de nível de documento, Ferramentas do Visual Studio para o Office apresenta dois controles de host do intervalo: o Controlarar de Microsoft.Office.Tools.Excel.NamedRange e o Controlarar de Microsoft.Office.Tools.Excel.XmlMappedRange.Para obter mais informações sobre controles de host, consulte Itens de host e Visão geral sobre controles de host.

Objetos estendidos no projetos de nível de documento

É importante compreender as diferenças entre os objetos nativos fornecidos pelo modelo de objeto do Excel e os objetos estendidos (itens de host e controles de host) fornecidos pelo Ferramentas do Visual Studio para o Office.Ambos tipos de objetos estão disponíveis para projetos de nível de documento.

As diferenças são nas seguintes quatro áreas:

Tempo de design.Quando você Adicionar qualquer um do Excel estendido objetos em tempo de design, eles são automaticamente criados como itens de host e controles de host.Por exemplo, se você adicionar uma lista para uma planilha no designer, código é automaticamente gerado para estender a lista em um Controlarar de Microsoft.Office.Tools.Excel.ListObject.
Tempo de execução.Itens de host não são criados automaticamente em tempo de execução.Se você adicionar pastas de trabalho, planilhas ou planilhas de gráfico em tempo de execução, elas são objetos de Excel nativos e não tem recursos adicionais que fornecem os itens de host.Você poderá programaticamente adicionar muitos dos controles host.For more information, see Itens de host e Visão geral sobre controles de host.
Ligação de dados e eventos.Itens de host e os controles de host têm recursos de ligação de dados e eventos, que não estão disponíveis para os objetos nativos.
Tipos.Os objetos nativos do Excel usam os tipos definidos no namespace Microsoft.Office.Interop.Excel , enquanto os itens de host e controles de host usam os tipos de agregados definidos no namespace Microsoft.Office.Tools.Excel.

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

Para obter informações sobre as classes que você pode usar no modelo de objeto do Excel, consulte os seguintes conjuntos de documentação:

O primeiro link fornece informações sobre as classes e interfaces do assembly de interoperabilidade primária para o Excel.Os outros links fornecem informações sobre o modelo de objeto do Excel como ele está exposto para o Visual Basic para código Applications (VBA).Cada conjunto de documentação tem vantagens e desvantagens para desenvolvedores que estiverem usando Ferramentas do Visual Studio para o Office.

Referência de assembly interoperabilidade primária

Esta documentação descreve Tudo tipos no Excel principal interop assembly que você pode usar em projetos de Ferramentas do Visual Studio para o Office.No entanto, esta documentação tem as seguintes desvantagens:

Ele descreve apenas os tipos no assembly de interoperabilidade primário para o Excel 2003.Para obter descrições dos novos tipos e membros no assembly de interoperabilidade primária para o Excel 2007, você deve consultar a referência do VBA para o Excel 2007.
Ele não fornece os exemplos de código no momento.

Referência do VBA

Tudo objetos e os membros a referência do VBA correspondem às classes e membros o assembly de interoperabilidade primária que você usar em projetos de Ferramentas do Visual Studio para o Office.Por exemplo, o objeto planilha a documentação do Excel em VBA corresponde à classe Microsoft.Office.Interop.Excel.Worksheet no assembly de interoperabilidade primário.

A referência do VBA apresenta as seguintes vantagens:

Ele documenta os modelos de objeto do Ambos Excel 2007 e Excel 2003.
Ela fornece exemplos de código para a maioria dos membros.

A referência do VBA possui as seguintes desvantagens:

Ela fornece exemplos de sintaxe e o código para VBA somente.Para usar os exemplos de código em um projeto Ferramentas do Visual Studio para o Office, você deve converter o código VBA para o Visual Basic ou Visual C#.

Tipos adicionais em assemblies de interoperabilidade primários

Os assemblies de interoperabilidade primários contêm muitos tipos que não estão disponíveis para VBA.Esses tipos adicionais ajudam a converter objetos no modelo de objeto de baseado em COM do Excel para código gerenciado, não devem ser usadas diretamente em seu código.

For more information, see Overview of Classes and Interfaces in the Office Primary Interop Assemblies.