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

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 Versão do Microsoft Office Microsoft Office Sistema de 2007 Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

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

Durante este explicação passo a passo, você aprenderá como:

• Adicionar controles a uma planilha.

• Configure um dataset para ser armazenada em cache em uma planilha.

• Adicionar código para ativar a rolagem pelos registros.

• Teste seu projeto.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de 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

Para concluir esta explicação passo a passo, será necessário:

• Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).

• O Microsoft Office Excel 2003 ou Microsoft Office Excel 2007.

• Acessar do Northwind SQL Servidor banco de dados de exemplo.O banco de dados pode estar no seu computador de desenvolvimento ou em um servidor.

• Permissões para ler e gravar para o SQL Servidor banco de dados.

Criando um novo projeto

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

Para criar um novo projeto

• Criar um projeto de pasta de trabalho do Excel com o nome meu Mestre-Detail, usando Visual Basic ou C#.Certifique-se de que Criar um documento novo está Selecionadoda.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

O Visual Studio abre a Novo pasta de trabalho do Excel no designer e adiciona o projeto meu Mestre-Detail para Gerenciador de Soluções.

Criando o DataSet

Use a janela de Data Sources para adicionar um dataset tipado ao seu projeto.

Para criar o DataSet

1. Se a janela de Data Sources não estiver visível, clique em do Show Data Sources no menu Dados.

2. Clique em Adicionar Nova Origem de Dados para iniciar o Fonte de Dados Configuration Assistente .

3. Selecione Database e clique em Next.

4. Selecionar uma conexão de dados ao exemplo a Northwind SQL Servidor banco de dados ou adicionar uma Novo conexão usando o botão de Novo conexão.

5. Depois de selecionar ou criar uma conexão, clique em Avançar de .

6. Desmarque a opção para salvar a conexão se for Selecionado e clique em Avançar de .

7. Expandirir o nó de tabelas na janela banco de dados de objetos.

8. Selecionar a tabela de pedidos e a tabela de detalhes do pedido.

9. Clique em Finish.

O assistente adiciona duas tabelas para a janela de fontes de dados.Ele também adiciona um dataset tipado ao seu projeto que está visível no Gerenciador de Soluções.

Adicionando controles para a planilha

Nesta etapa, você irá adicionar um intervalo nomeado, um objeto de lista e dois botões para a Primeiro planilha.Primeiro, Adicionar o intervalo nomeado e a lista de objetos da janela Data Sources para que eles são Ligados automaticamente à fonte de dados.Avançar, Adicionar os botões da caixa de ferramentas .

Para adicionar um intervalo nomeado e um objeto de lista

1. Verifique se a pasta de trabalho Meu mestre-Detail.xls Abrir no designer do Visual Studio, com Sheet1 exibido.

2. Abrir Dados janela de Dadosta Sources e Expandirir o nó de Orders.

3. Selecionar a coluna de CódigoDoPedido e clique em suspensa Para Baixo seta que aparece.

4. Clique em NamedRange Soltar Soltar-Para Baixo e arraste a coluna de OrderID à célula A2.

   Um Controlarar de NamedRange chamado OrderIDNamedRange é criado na célula A2.Ao mesmo tempo, um BindingSource denominados OrdersBindingSource, um adaptador de tabela e uma instância de DataSet são adicionados ao projeto.O Controlarar está Ligado a BindingSource, que por sua vez é Ligados para a instância de DataSet.

5. Role para baixo as colunas que estão sob a tabela de pedidos anteriores.Na parte inferior da lista é a tabela de De detalhes do Ordem; é aqui porque ele é um filho da tabela pedidos.Selecionar esta tabela de detalhes do pedido, não a um que esteja no mesmo nível da tabela de pedidos e clique em suspensa Para Baixo seta que aparece.

6. Click ListObject in the drop-down list, and then drag the OrderDetails table to cell A6.

7. Um Controlarar de ListObject chamado Order_DetailsListObject é criado na célula A6e Ligado para o BindingSource.

Para adicionar dois botões

1. Na guia Controles ComumComumum da caixa de ferramentas **,**Adicionar Comumum controle de Button a A3 da planilha da célula.

   Esse botão é denominado Button1.

2. Adicionar Button outro Controlarar para a célula B3 da planilha.

   Esse botão é denominado Button2.

Avançar, marca o dataset para ser armazenada 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úblico e Configuração CacheInDocument propriedade.

Em cache o dataset

1. Selecionar NorthwindDataSet na bandeja do componente.

2. Na janela Properties, Alterar Modificadores propriedade de a Público.

   Conjuntos de dados devem ser públicos antes de armazenamento em cache está Habilitado.

3. Alterar CacheInDocument propriedade de a Verdadeiro.

A Avançar etapa é adicionar texto aos botões e, em C#, adicione código para ligar os manipuladores de eventos.

Inicializar os controles

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

Ao inicializar os dados e os controles

1. Em Gerenciador de Soluções, clique com o botão direito do mouse Sheet1.vb ou Sheet1.cse clique em Exibir Code no menu de atalho.

2. Adicionar o código a seguir para o método Sheet1_Startup para definir o texto para os botões.

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

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

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

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

Adicionando código para habilitar a rolagem através de registros do

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

Para percorrer os registros

1. Adicionar um manipulador de eventos para o evento Click de Button1, e Adicionar o seguinte código para percorrer os registros com versões anteriores:

   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. Adicionar um manipulador de eventos para o evento Click de Button2, e Adicionar 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();
   }
   

Testando o aplicativo

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

Para testar o cache de dados

1. Pressione F5.

2. Verifique se que o intervalo nomeado e o objeto de lista são preenchidas com dados da Origem de dados.

3. Percorra alguns dos registros clicando nos botões.

4. Salvar a pasta de trabalho e, em seguida, feche a pasta de trabalho e o Visual Studio.

5. Desativar a conexão com o banco de dados.Desconecte o cabo de rede do seu computador se o banco de dados estiver localizado em um servidor ou parar o serviço do SQL Server se o banco de dados estiver em seu computador de desenvolvimento.

6. Excel Abrir e, em seguida, Abrir Meu mestre-Detail.xls no diretório \bin (\My Master-Detail\bin no Visual Basic ou \My Master-Detail\bin\Depurar em C#).

7. Role alguns dos registros para ver que a planilha funciona normalmente quando desconectado.

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

Próximas etapas

Esta explicação passo a passo mostra as noções básicas de criação de um relacionamento de dados Mestre/detail em uma planilha e cache de um dataset.Aqui estão algumas tarefas que podem vie em seguida:

• Implantar a solução.Para mais informações, consulte: Implantar soluções do Office.

• Recuperar dados de o cache de outro projeto.For more information, see Como: Recuperar dados de uma pasta de trabalho em um servidor armazenados em cache.

Consulte também

Conceitos

Vinculando dados a controles

Cache de dados

Itens de host e Visão geral sobre controles de host

Outros recursos

Dados em soluções do Office