Demonstra Passo a passo: Ligação de dados complexa em um projeto de nível de aplicativo

Artigo
08/08/2011

Você pode vincular dados a controles de host e controles de Windows Forms em projetos de nível de aplicativo. Esta explicação passo a passo demonstra como adicionar controles a uma planilha do Excel de Microsoft Office e vincular controles a dados em tempo de execução.

Aplicável a: As informações neste tópico se aplicam a 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.

This walkthrough illustrates the following tasks:

Adicionando um ListObject o controle para uma planilha em tempo de execução.
Criando um BindingSource que conecta o controle a uma instância de um dataset.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

Excel 2007 ou Excel 2010.
Acesso a uma instância em execução do SQL Server 2005 ou o SQL Server 2005 Express que tem o AdventureWorksLT o banco de dados de exemplo está anexado ao proprietário. Você pode baixar o AdventureWorksLT de banco de dados da site CodePlex da. Para obter mais informações sobre a anexação de um banco de dados, consulte os seguintes tópicos:
- Para anexar um banco de dados usando o SQL Server Management Studio ou o SQL Server Management Studio Express, consulte como: Anexar um banco de dados (SQL Server Management Studio).
- Para anexar um banco de dados usando a linha de comando, consulte como: Anexar um arquivo de banco de dados de SQL Server Express.

Creating a New Project

A primeira etapa é criar um projeto de suplemento do Excel.

Para criar um novo projeto.

Crie um projeto de suplemento do Excel com as planilhas de preenchimento de nome de um banco de dados, usando Visual Basic ou C#.

For more information, see Como: Criar projetos do Office em Visual Studio.

Abre a Visual Studio a ThisAddIn.vb ou ThisAddIn.cs de arquivo e adiciona as planilhas de preenchimento de um projeto de banco de dados para Solution Explorer.

Creating a Data Source

Use o Fontes de dados janela para adicionar um dataset tipado ao seu projeto.

Para adicionar um dataset tipado ao projeto

On the Data menu, click Add New Data Source.

The Data Source Configuration Wizard opens.
Clique em banco de dadose em seguida, clique em próximo.
Se você tiver uma conexão existente com o AdventureWorksLT banco de dados, escolha esta conexão e clique em próximo.

Caso contrário, clique em Nova conexãoe usar o Add Connection caixa de diálogo Criar nova conexão. For more information, see Como: Conectar-se a Dados em um Banco de Dados.
No Save the Connection String no arquivo de configuração do aplicativo página, clique em próximo.
No Escolha seus objetos de banco de dados de página, expanda tabelas e selecione endereço (SalesLT).
Click Finish.

O arquivo AdventureWorksLTDataSet.xsd é adicionado ao Solution Explorer. Esse arquivo define os seguintes itens:
- A typed dataset named AdventureWorksLTDataSet. Este dataset representa o conteúdo na endereço (SalesLT) tabela no banco de dados AdventureWorksLT.
- A TableAdapter named AddressTableAdapter. Isso TableAdapter pode ser usado para ler e gravar dados na AdventureWorksLTDataSet. For more information, see Visão geral do TableAdapter.
Você usará dois desses objetos posteriormente nesta explicação passo a passo.

Criando controles e controles de ligação a dados

Para esta explicação passo a passo, o ListObject controle exibe todos os dados na tabela selecionada assim que o usuário abre a pasta de trabalho. O objeto de lista usa um BindingSource para conectar o controle para o banco de dados.

Para obter mais informações sobre controles de vinculação de dados, consulte A ligação de dados a controles em soluções do Office.

Para adicionar o objeto de lista, o dataset e o adaptador de tabela

No ThisAddIn da classe, declare os seguintes controles para exibir o Address índice da AdventureWorksLTDataSet dataset.

Private addressListObject As Microsoft.Office.Tools.Excel.ListObject
Private adventureWorksDataSet As AdventureWorksLTDataSet
Private addressTableAdapter As AdventureWorksLTDataSetTableAdapters.AddressTableAdapter
Private addressBindingSource As System.Windows.Forms.BindingSource

private Microsoft.Office.Tools.Excel.ListObject addressListObject;
private AdventureWorksLTDataSet adventureWorksDataSet;
private AdventureWorksLTDataSetTableAdapters.AddressTableAdapter addressTableAdapter;
private System.Windows.Forms.BindingSource addressBindingSource;

No ThisAddIn_Startup método, adicione o seguinte código para inicializar o dataset e preencher o dataset com informações sobre o AdventureWorksLTDataSet dataset.

Me.addressTableAdapter = New AdventureWorksLTDataSetTableAdapters.AddressTableAdapter()
Me.adventureWorksDataSet = New AdventureWorksLTDataSet()
Me.addressTableAdapter.Fill(Me.adventureWorksDataSet.Address)
Me.addressBindingSource = New System.Windows.Forms.BindingSource()

this.addressTableAdapter = new AdventureWorksLTDataSetTableAdapters.AddressTableAdapter();
this.adventureWorksDataSet = new AdventureWorksLTDataSet();
this.addressTableAdapter.Fill(this.adventureWorksDataSet.Address);
this.addressBindingSource = new System.Windows.Forms.BindingSource();

Add the following code to the ThisAddIn_Startup method. Isso gera um item de host que estende a planilha. For more information, see Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Observação
O exemplo a seguir funciona em projetos de destino .NET Framework 4. Para usar este exemplo em projetos de destino.NET Framework 3.5, consulte os comentários no código.

Dim worksheet As Excel.Worksheet = DirectCast(Me.Application.ActiveWorkbook.Worksheets(1), Excel.Worksheet)

' Create a workhseet host item for .NET Framework 4 projects.
Dim extendedWorksheet As Worksheet = Globals.Factory.GetVstoObject(worksheet)

' For .NET Framework 3.5 projects, use the following code to create a worksheet host item.
' Dim extendedWorksheet As Worksheet = worksheet.GetVstoObject()

Excel.Worksheet worksheet = (Excel.Worksheet)this.Application.ActiveWorkbook.Worksheets[1];
// Create a workhseet host item for .NET Framework 4 projects.
Worksheet extendedWorksheet = Globals.Factory.GetVstoObject(worksheet);

// For .NET Framework 3.5 projects, use the following code to create a worksheet host item.
// Worksheet extendedWorksheet = worksheet.GetVstoObject();

Criar um intervalo e adicionar o ListObject de controle.

Dim cell As Excel.Range = extendedWorksheet.Range("$A$1:$G$5", System.Type.Missing)
Me.addressListObject = extendedWorksheet.Controls.AddListObject(cell, "list1")

Excel.Range cell = extendedWorksheet.Range["$A$1:$G$5", System.Type.Missing];
this.addressListObject = extendedWorksheet.Controls.AddListObject(cell, "list1");

Vincular o objeto de lista para AdventureWorksLTDataSet usando o BindingSource. Passar os nomes das colunas que você deseja vincular o objeto de lista.

Me.addressBindingSource.DataSource = Me.adventureWorksDataSet.Address
Me.addressListObject.AutoSetDataBoundColumnHeaders = True
Me.addressListObject.SetDataBinding( _
    Me.addressBindingSource, "", "AddressID", "AddressLine1", _
    "AddressLine2", "City", "StateProvince", "CountryRegion", "PostalCode")

this.addressBindingSource.DataSource = this.adventureWorksDataSet.Address;
this.addressListObject.AutoSetDataBoundColumnHeaders = true;
this.addressListObject.SetDataBinding(
    this.addressBindingSource, "", "AddressID", "AddressLine1", 
    "AddressLine2", "City", "StateProvince", "CountryRegion", "PostalCode");

Testando o suplemento

Quando você abre o Excel, o ListObject controle exibe os dados da Address índice da AdventureWorksLTDataSet dataset.

Para testar o suplemento

Press F5.

A ListObject controle chamado addressListObject é criado na planilha. At a mesma hora, um objeto dataset chamado adventureWorksLTDataSet e um BindingSource chamado addressBindingSource são adicionados ao projeto. O ListObject está vinculado a BindingSource, que por sua vez é vinculado a objeto dataset.

Consulte também

Compartilhar via

Demonstra Passo a passo: Ligação de dados complexa em um projeto de nível de aplicativo

Pré-requisitos

Creating a New Project

Para criar um novo projeto.

Creating a Data Source

Para adicionar um dataset tipado ao projeto

Criando controles e controles de ligação a dados

Para adicionar o objeto de lista, o dataset e o adaptador de tabela

Testando o suplemento

Para testar o suplemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais