Demonstra Passo a passo: Criar uma relação mestre/detalhes usando um Dataset em cache

Este passo a passo demonstra como criar uma relação mestre/detalhes em uma planilha e cache os dados para que a solução pode ser usada offline.

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

During this walkthrough, you will learn how to:

• Adicione controles a uma planilha.

• Configure um dataset seja armazenada em cache em uma planilha.

• Adicione código para ativar a percorrer os registros.

• Teste seu projeto.

Observação
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

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).

• Microsoft Office Excel 2007 ou Excel 2010.

• Acesso ao banco de dados de exemplo Northwind de SQL Server. O banco de dados pode ser no computador de desenvolvimento ou em um servidor.

• Permissões para ler e gravar no banco de dados de SQL Server.

Creating a New Project

Nesta etapa, você criará um projeto da pasta de trabalho do Excel.

Para criar um novo projeto.

• Criar um projeto da pasta de trabalho do Excel com o nome Minhas Master-Detail, usando Visual Basic ou C#. Certifique-se de que criar um novo documento está selecionada. For more information, see Como: Criar projetos do Office em Visual Studio.

Abre a nova pasta de trabalho do Excel no designer de Visual Studio e adiciona o projeto mestre-detalhe meu Solution Explorer.

Creating the Data Source

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

To create the data source

1. Se o Fontes de dados janela não estiver visível, clique em Show Data Sources sobre o dados menu.

2. Clique em Add New Data Source para iniciar o Data Source Configuration Wizard.

3. Select Database and then click Next.

4. Selecione uma conexão de dados no banco de dados de SQL Server de exemplo Northwind ou adicionar uma nova conexão usando o Nova conexão botão.

5. Após selecionar ou criar uma conexão, clique em próximo.

6. Desmarque a opção para salvar a conexão se estiver selecionada e clique próximo.

7. Expanda o tabelas nó a os objetos de banco de dados janela.

8. Selecione o pedidos tabela e o Detalhes do pedido tabela.

9. Click Finish.

O assistente adiciona duas tabelas para o Fontes de dados janela. Ele também adiciona um dataset tipado ao seu projeto que está visível no Solution Explorer.

Adicionando controles para a planilha.

Nesta etapa, você irá adicionar um intervalo nomeado, um objeto de lista e dois botões à primeira planilha. Primeiro, adicione o intervalo nomeado e o objeto de lista a partir de Fontes de dados janela para que eles são vinculados automaticamente a fonte de dados. Em seguida, adicione os botões da caixa de ferramentas.

Para adicionar um intervalo nomeado e um objeto de lista

1. Verifique o Meu mestre-Detail.xls pasta de trabalho está aberta no designer de Visual Studio, com Sheet1 exibida.

2. Abrir o Fontes de dados janela e expanda o pedidos nó.

3. Selecione o OrderID coluna e em seguida, clique na seta suspensa que aparece.

4. Clique em NamedRange na lista suspensa e, em seguida, arraste o OrderID coluna à célula A2.

   A NamedRange controle chamado OrderIDNamedRange é criado na célula A2. Ao mesmo tempo, um BindingSource chamado OrdersBindingSource, um adaptador de tabela e um DataSet instância são adicionados ao projeto. O controle está vinculado a BindingSource, que por sua vez está vinculado a DataSet instância.

5. Rolar para baixo as colunas que estão sob o pedidos tabela. Na parte inferior da lista é o Detalhes do pedido tabela; aqui é porque ele é um filho de pedidos tabela. Selecione esta opção Detalhes do pedido da tabela, não aquele que é o mesmo nível, como o pedidos da tabela e, em seguida, clique na seta suspensa que aparece.

6. Clique em ListObject na lista suspensa e, em seguida, arraste o ordem detalhes tabela a célula A6.

7. A ListObject controle chamado Order_DetailsListObject é criado na célula A6e vinculados a BindingSource.

Para adicionar dois botões

1. Da Controles comuns guia da caixa de ferramentas, adicionar um Button controle para a célula A3 da planilha.

   Este botão é denominado Button1.

2. Adicionar outro Button o controle à célula B3 da planilha.

   Este botão é denominado Button2.

Em seguida, marca o conjunto de dados armazenados em cache no documento.

Armazenamento em cache o Dataset.

Marcar o dataset para ser armazenada em cache no documento, tornando o conjunto de dados pública e a configuração do CacheInDocument propriedade.

Armazenar em cache o dataset.

1. Selecione NorthwindDataSet na bandeja do componente.

2. No Propriedades janela, alterar o modificadores propriedade para pública.

   Conjuntos de dados devem ser públicos antes que o cache está ativado.

3. Alterar o CacheInDocument propriedade para True.

A próxima etapa é adicionar texto aos botões e no C# adicionar código para ligar os manipuladores de eventos.

Ao inicializar os controles

Definir o texto do botão e adicionar manipuladores de eventos durante a Startup de evento.

Para inicializar os dados e os controles

1. Em Solution Explorer, com o botão direito Sheet1.vb ou Sheet1.cse em seguida, clique em Exibir código no menu de atalho.

2. Adicione o seguinte código para o Sheet1_Startup método para definir o texto para os botões.

   Me.Button1.Text = "<"
   Me.Button2.Text = ">"
   

   this.button1.Text = "<";
   this.button2.Text = ">";
   

3. Para C# apenas, adicionar manipuladores de eventos para o botão de clique em eventos para o Sheet1_Startup método.

   this.button1.Click += new EventHandler(button1_Click);
   this.button2.Click += new EventHandler(button2_Click);
   

Adicionando código para ativar a rolar registros

Adicione código para o Click o manipulador de eventos de cada botão para percorrer os registros.

Para percorrer os registros

1. Adiciona um manipulador de eventos para o Click o evento de Button1e adicione o seguinte código para percorrer os registros para trás:

   Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles Button1.Click
   
       Me.OrdersBindingSource.MovePrevious()
   End Sub
   

   private void button1_Click(object sender, EventArgs e)
   {
       this.ordersBindingSource.MovePrevious();
   }
   

2. Adiciona um manipulador de eventos para o Click o evento de Button2e adicione o código a seguir para avançar pelos registros:

   Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles Button2.Click
   
       Me.OrdersBindingSource.MoveNext()
   End Sub
   

   private void button2_Click(object sender, EventArgs e)
   {
       this.ordersBindingSource.MoveNext();
   }
   

Testing the Application

Agora você pode testar a sua pasta de trabalho para certificar-se de que os dados são exibidos conforme o esperado, e que você pode usar a solução off-line.

Para testar o cache de dados

1. Press F5.

2. Verifique se o intervalo nomeado e o objeto de lista são preenchidos com dados da fonte de dados.

3. Rolar alguns registros clicando nos botões.

4. Salve a pasta de trabalho e feche a pasta de trabalho e Visual Studio.

5. Desabilite a conexão ao banco de dados. Desconecte o cabo de rede do seu computador, se o banco de dados está localizado em um servidor ou interromper o serviço de SQL Server se o banco de dados em seu computador de desenvolvimento.

6. Abra o Excel e, em seguida, abra Meu mestre-Detail.xls do diretório \bin (\My Master-Detail\bin em Visual Basic ou \My Master-Detail\bin\debug em C#).

7. Rolar alguns dos registros para ver que a planilha opera normalmente quando desconectado.

8. Reconecte-se ao banco de dados. Conectar seu computador à rede novamente se o banco de dados está localizado em um servidor ou iniciar o serviço de SQL Server se o banco de dados em seu computador de desenvolvimento.

Próximas etapas

Esta explicação passo a passo mostra noções básicas de criar uma relação de dados mestre/detalhes em uma planilha e o cache de um dataset. Here are some tasks that might come next:

• Implante a solução. For more information, see Deploying Office Solutions

• Recupere dados do cache para outro projeto. For more information, see Como: Recuperar dados em cache a partir de uma pasta de trabalho em um servidor.

Consulte também

Conceitos

Cache de dados

Itens de host e a visão geral sobre controles de Host

Outros recursos

A ligação de dados a controles em soluções do Office

Dados em soluções do Office