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

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

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

Essa explicação passo a passo mostra as seguintes tarefas:

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

• Adicionando controles associados a dados a uma planilha.

• Salvar dados alterações de volta para o 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 de Visual Studio.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

-

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).

• Excel 2013 ou Excel 2010. 

• Acesso a um servidor com o banco de dados de exemplo Northwind SQL Server.

• Permissões leitura e gravação no banco de dados SQL Server.

Criando um novo projeto

A primeira etapa é criar um projeto de pasta de trabalho do Excel.

Para criar um novo projeto

• Crie um projeto de pasta de trabalho do Excel com o nome Minha associação de dados complexos.No assistente, selecione Criar um Novo Documento.

  Para obter mais informações, consulte Como: criar projetos do Office em Visual Studio.

  O Visual Studio abre a nova pasta de trabalho do Excel no designer e adiciona meu projeto de associação de dados complexos a Gerenciador de Soluções.

Criando o DataSet

Use a janela de Fontes de Dados para adicionar um dataset tipado ao seu projeto.

Para criar o DataSet

1. Se a janela de Fontes de Dados não estiver visível, exibi-la por, na barra de menus, escolhendo Modo de Visualização, Outras Janelas, Fontes de Dados.

2. Escolha Adicionar Nova Fonte de Dados para iniciar Assistente para Configuração de Fonte de Dados.

3. Selecione Database e clique em Next.

4. Selecione uma conexão de dados ao banco de dados SQL Server de exemplo Northwind, ou adicione uma nova conexão usando o botão de Nova Conexão .

5. Após uma conexão foi selecionada ou criada, clique Avançar.

6. Desmarque a opção para salvar a conexão se está selecionada, e clique em Avançar.

7. Expanda o nó de Tabelas na janela de Objetos de Banco de Dados .

8. Selecione a caixa de seleção próxima à tabela de Funcionários .

9. Clique em Concluir.

O assistente adiciona a tabela de Funcionários para a janela de Fontes de Dados .Ele também adiciona um dataset tipado ao seu projeto que está visível em Gerenciador de Soluções.

Adicionando controles à planilha

Uma planilha exibirá a tabela de Funcionários quando a pasta de trabalho é aberta.Os usuários poderão fazer alterações aos dados e salve as alterações de volta para o banco de dados clicando em um botão.

Para associar a planilha a tabela automaticamente, você pode adicionar um controle de ListObject a planilha da janela de Fontes de Dados .Para conceder ao usuário a opção salvar as alterações, adicione um controle de Button de Caixa de Ferramentas.

Para adicionar um objeto de lista

1. Verifique se a pasta de trabalho de Meus dados complexos Binding.xlsx é aberta no designer do Visual Studio, com Plan1 exibida.

2. Abra a janela de Fontes de Dados e selecione o nó de Funcionários .

3. Clique na seta suspensa que aparece.

4. ListObject selecione na lista suspensa.

5. Arraste a tabela de Funcionários a célula A6.

   Um controle de ListObject chamado EmployeesListObject é criado na célula A6.Ao mesmo tempo, BindingSource chamado EmployeesBindingSource, um adaptador da tabela, e uma instância de DataSet são adicionados ao projeto.O controle é associado a BindingSource, que por sua vez é associado à instância de DataSet .

Para adicionar um botão

• Na guia de Controles Comuns de Caixa de Ferramentas, adicione um controle de Button a célula A4 a planilha.

A próxima etapa é adicionar texto ao botão quando a planilha abre.

Inicializando o controle

Adicione o texto no botão no manipulador de eventos Startup .

Para inicializar o controle

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

2. Adicione o seguinte código ao método de Sheet1_Startup para definir o texto douttonb.

   Me.Button1.Text = "Save"
   

   this.button1.Text = "Save";
   

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

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

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

Salvar alterações no banco de dados

Todas as alterações foram feitas aos dados existem somente no conjunto de dados local até que eles sejam salvas explicitamente de volta para o banco de dados.

Para salvar as alterações para o banco de dados

• Adicionar um manipulador de eventos para o evento de Click deuttonb, e adicione o seguinte código para confirmar todas as alterações que foram feitas no dataset de volta para o 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);
      }
  }
  

Testando o aplicativo

Agora você pode testar sua pasta de trabalho para verificar que os dados aparecem como esperado, e que você pode manipular os dados no objeto de lista.

Para testar a associação de dados

• Pressione F5.

  Verifique que quando a pasta de trabalho, abra o objeto de lista é preenchido com dados da tabela de Funcionários .

Para modificar dados

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

2. Digite o nome Anderson, e pressione ENTER.

Para alterar um cabeçalho de coluna

1. Clique na célula que contém o cabeçalho de coluna Sobrenome.

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

Para salvar dados

1. Clique em Salvar planilha.

2. Sair do excel.Clique Não quando solicitado a salvar as alterações que você fez.

3. Pressione F5 para executar novamente o projeto.

   O objeto de lista é preenchido com dados da tabela de Funcionários .

4. Observe que o nome na célula B7 é ainda Anderson, que é a modificação de dados que você fez e salvou de volta para o banco de dados.O cabeçalho de coluna Sobrenome mudou de volta para sua forma original sem nenhum espaço, como o cabeçalho não é associado ao banco de dados e você não salvar as alterações que você fez a 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 de nova linha.

2. Adicione a seguinte informações na linha vazia.

   Código Do Funcionário	Sobrenome	Nome	Nome
   10	Ito	Shu	Gerenciador de vendas

Para excluir linhas

• Clique com o botão direito do mouse o número 16 (linha 16) à esquerda o lado de extrema esquerda da planilha, e clique em Excluir.

Para classificar as linhas na lista

1. Selecione uma célula na lista.

   Os botões de seta aparecem em cada cabeçalho de coluna.

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

3. Clique Ordenação Crescente.

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

Para filtrar informações

1. Selecione uma célula na lista.

2. Clique no botão de seta no cabeçalho de coluna Título .

3. Clique Representante de Vendas.

   A lista a seguir mostra somente as linhas que têm Representante de Vendas na coluna de Título .

4. Clique no botão de seta no cabeçalho de coluna Título novamente.

5. Clique (Todos).

   A filtragem é removida e todas as linhas aparecem.

Próximas etapas

Essa explicação passo a passo mostra as noções básicas de associar uma tabela em um banco de dados a um objeto de lista.Aqui estão algumas tarefas que podem vie em seguida:

• Armazenar em cache os dados de modo que pode ser usado offline.Para obter mais informações, consulte Como: os dados em Cache para uso off-line ou em um servidor.

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

• Criar um relacionamento mestre/detalhe entre um campo e uma tabela.Para obter mais informações, consulte Passo a passo: Criando uma relação mestre/detalhes usando um Dataset em cache.

Consulte também

Tarefas

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

Data in Office Solutions