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

Esta explicação passo a passo demonstra as noções básicas de ligação de dados complexa em um projeto de nível de documento. Você pode vincular várias células em uma planilha do Excel de Microsoft Office a campos no banco de dados Northwind de SQL Server.

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.

This walkthrough illustrates the following tasks:

• Adicionando uma fonte de dados ao seu projeto de pasta de trabalho.

• Adicionando controles ligados a dados para uma planilha.

• Salvando as alterações de dados no banco de dados.

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 um servidor de banco de dados de exemplo Northwind de SQL Server.

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

Creating a New Project

A primeira etapa é 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 Meus Complex Data Binding. No assistente, selecione criar um novo documento.

  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 meu Complex Data Binding para 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, no dados menu, clique em Show Data Sources.

   Observação
   Se Show Data Sources não estiver disponível, clique dentro da pasta de trabalho do Excel e verifique novamente.

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. Depois de uma conexão foi selecionada ou criada, 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. Marque a caixa de seleção ao lado do os funcionários tabela.

9. Click Finish.

O assistente adiciona o os funcionários tabela 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.

Uma planilha exibirá o os funcionários tabela quando a pasta de trabalho é aberta. Os usuários poderão fazer alterações aos dados e salvar essas alterações no banco de dados clicando em um botão.

Para vincular a planilha para a tabela automaticamente, você pode adicionar um ListObject a planilha de controle a Fontes de dados janela. Para dar ao usuário a opção para salvar as alterações, adicionar um Button de controle da caixa de ferramentas.

Para adicionar um objeto de lista

1. Verifique o Meus Binding.xls de dados complexos pasta de trabalho está aberta no designer de Visual Studio, com Sheet1 exibida.

2. Abrir o Fontes de dados janela e selecione o funcionários nó.

3. Clique na seta suspensa que aparece.

4. Selecione ListObject na lista drop-down.

5. Arraste o os funcionários tabela a célula A6.

   A ListObject controle chamado EmployeesListObject é criado na célula A6. Ao mesmo tempo, um BindingSource chamado EmployeesBindingSource, 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.

Para adicionar um botão

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

A próxima etapa é adicionar o texto do botão quando a planilha for aberta.

Inicializar o controle

Adicionar texto ao botão da Startup manipulador de eventos.

Ao inicializar o controle

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 a button.

   Me.Button1.Text = "Save"
   

   this.button1.Text = "Save";
   

3. Para C# apenas, adicione um manipulador para o Click evento para o Sheet1_Startup método.

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

Agora, adicione código para manipular o Click o evento do botão.

Salvar as alterações no banco de dados

As alterações foram feitas para os dados existem somente no dataset local até que eles são explicitamente salvas no banco de dados.

Para salvar as alterações no banco de dados

• Adiciona um manipulador de eventos para o Click o evento da buttone adicione o seguinte código para confirmar todas as alterações feitas no dataset volta ao banco de dados.

  Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
      Handles Button1.Click
  
      Try
          Me.EmployeesTableAdapter.Update(Me.NorthwindDataSet.Employees)
  
      Catch ex As System.Data.DataException
          MessageBox.Show(ex.Message)
      End Try
  End Sub
  

  private void button1_Click(object sender, EventArgs e)
  {
      try
      {
          this.employeesTableAdapter.Update(this.northwindDataSet.Employees);
      }
      catch (System.Data.DataException ex)
      {
          MessageBox.Show(ex.Message);
      }
  }
  

Testing the Application

Agora você pode testar a sua pasta de trabalho para verificar os dados são exibidos conforme o esperado, e que você pode manipular os dados no objeto da lista.

Para testar a ligação de dados

• Press F5.

  Verifique se que, quando abre a pasta de trabalho, o objeto da lista é preenchido com dados a partir de funcionários tabela.

Para modificar dados

1. Clique na célula B7, que deve conter o nome Davolio.

2. Digite o nome Anderson e pressione ENTER.

Para modificar um cabeçalho de coluna

1. Clique na célula que contém o cabeçalho da coluna LastName.

2. Digite o sobrenome, incluindo um espaço entre as duas palavras e então pressione ENTER.

Para salvar dados

1. Clique em Salvar na planilha.

2. Saia do Excel. Clique em não quando solicitado a salvar as alterações feitas.

3. Pressione F5 para executar o projeto novamente.

   O objeto da lista é preenchido com dados a partir de funcionários tabela.

4. Observe que o nome na célula B7 é ainda Anderson, que é a alteração de dados que você fez e salvo no banco de dados. No cabeçalho da coluna LastName mudou voltar ao formato original, sem espaço, porque o cabeçalho de coluna não está vinculado ao banco de dados e você não salvou as alterações feitas na planilha.

Para adicionar novas linhas

1. Selecione uma célula dentro do objeto de lista.

   Uma nova linha aparece na parte inferior da lista, com um asterisco (*) na primeira célula da nova linha.

2. Adicione as seguintes informações na linha vazia.

   EmployeeID	Sobrenome	FirstName	Title
   10	Ito	Shu	Gerente de vendas

Para excluir linhas

• O número de 16 (linha 16) no lado esquerdo da planilha com o botão direito e clique em Excluir.

Para classificar as linhas na lista

1. Selecione uma célula dentro da lista.

   Botões de seta aparecerão em cada cabeçalho de coluna.

2. Clique no botão de seta para a Sobrenome cabeçalho da coluna.

3. Clique em classificação crescente.

   As linhas são classificadas em ordem alfabética por sobrenome.

Para filtrar informações

1. Selecione uma célula dentro da lista.

2. Clique no botão de seta para a título cabeçalho da coluna.

3. Clique em o representante de vendas.

   A lista mostra somente as linhas que possuem Representante de vendas na título coluna.

4. Clique no botão de seta para a título cabeçalho da coluna novamente.

5. Clique em (todos).

   A filtragem é removida e todas as linhas aparecem.

Próximas etapas

Esta explicação passo a passo mostra noções básicas de ligação de uma tabela em um banco de dados para um objeto de lista. Here are some tasks that might come next:

• Os dados em cache para que possam ser usado off-line. For more information, see Como: Cache de dados para uso off-line ou em um servidor.

• Implante a solução. For more information, see Implantar soluções do Office.

• Crie uma relação mestre/detalhe entre um campo e uma tabela. For more information, see Demonstra Passo a passo: Criar uma relação mestre/detalhes usando um Dataset em cache.

Consulte também

Tarefas

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

Outros recursos

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

Dados em soluções do Office