Passo a passo: Ligação de dados simples 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 em um projeto de um documento nível.Um campo de dados em um banco de dados SQL Server é associado a um intervalo nomeado no Microsoft Office Excel.A explicação passo a passo também mostra como adicionar controles que permitem que você percorrer de todos os registros na tabela.

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:

• Criando uma fonte de dados para um projeto do excel.

• Adicionando controles a uma planilha.

• Rolagem pelos registros do 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

Nesta etapa, você 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 simples, usando Visual Basic ou C#.Certifique-se de que Criar um Novo Documento está selecionado.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 simples 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 Clientes .

9. Clique em Concluir.

O assistente adicione a tabela de Clientes 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

Para essa explicação passo a passo, você precisar dois intervalos nomeados e quatro botões na primeira planilha.Primeiro, adicione os dois intervalos chamados a partir da janela de Fontes de Dados para que sejam automaticamente associados à fonte de dados.Em seguida, adicione os botões de Caixa de Ferramentas.

Para adicionar dois intervalos nomeados

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

2. Abra a janela de Fontes de Dados e expanda o nó de Clientes .

3. Selecione a coluna de CompanyName , clique na seta suspensa que aparece.

4. NamedRange selecione na lista suspensa, e arraste na coluna de CompanyName para a célula A1.

   Um controle de NamedRange chamado companyNameNamedRange é criado na célula A1.Ao mesmo tempo, BindingSource chamado customersBindingSource, 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 .

5. Selecione a coluna de IDCliente na janela de Fontes de Dados , e clique na seta suspensa que aparece.

6. Clique NamedRange na lista suspensa e em seguida, arraste a coluna de IDCliente para a célula B1.

7. Outro controle de NamedRange chamado customerIDNamedRange é criado na célula B1, e na associação a BindingSource.

Para adicionar quatro botões

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

   Este botão é chamado Button1.

2. Para adicionar três mais botões para as células na ordem, de modo que os nomes sejam como mostrado:

   Célula	(Name)
   B3	Button2
   C3	Button3
   D3	Button4

A próxima etapa é adicionar texto aos botões, e em C# adicionar manipuladores de eventos.

Inicializando controles

Defina o texto do botão e adiciona manipuladores de eventos durante o evento de Startup .

Para inicializar os controles

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 para cada botão.

   With Me
       .Button1.Text = "|<"
       .Button2.Text = "<"
       .Button3.Text = ">"
       .Button4.Text = ">|"
   End With
   

   this.button1.Text = "|<";
   this.button2.Text = "<";
   this.button3.Text = ">";
   this.button4.Text = ">|";
   

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

   this.button1.Click += new EventHandler(button1_Click);
   this.button2.Click += new EventHandler(button2_Click);
   this.button3.Click += new EventHandler(button3_Click);
   this.button4.Click += new EventHandler(button4_Click);
   

Agora adicione código para manipular eventos de Click dos botões de modo que o usuário pode procurar pelos registros.

Adicionando código para permitir a rolagem pelos registros

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

Para mover para o primeiro registro

• Adicionar um manipulador de eventos para o evento de Click de botão de Button1 , e adicione o seguinte código para mover para o primeiro registro:

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

  private void button1_Click(object sender, System.EventArgs e)
  {
      this.customersBindingSource.MoveFirst();
  }
  

Para mover para o registro anterior

• Adicionar um manipulador de eventos para o evento de Click de botão de Button2 , e adicione o seguinte código para mover a trás da posição por uma:

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

  private void button2_Click(object sender, System.EventArgs e)
  {
      this.customersBindingSource.MovePrevious(); 
  }
  

Para mover para o próximo registro

• Adicionar um manipulador de eventos para o evento de Click de botão de Button3 , e adicione o seguinte código para a posição em seguida por uma:

  Private Sub Button3_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
      Handles Button3.Click
  
      Me.CustomersBindingSource.MoveNext()
  End Sub
  

  private void button3_Click(object sender, System.EventArgs e)
  {
      this.customersBindingSource.MoveNext();
  }
  

Para mover o último registro

• Adicionar um manipulador de eventos para o evento de Click de botão de Button4 , e adicione o seguinte código para mover o último registro:

  Private Sub Button4_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
      Handles Button4.Click
  
      Me.CustomersBindingSource.MoveLast()
  End Sub
  

  private void button4_Click(object sender, System.EventArgs e)
  {
      this.customersBindingSource.MoveLast();
  }
  

Testando o aplicativo

Agora você pode testar sua pasta de trabalho para certificar-se de que você pode procurar pelos registros no banco de dados.

Para testar sua pasta de trabalho

1. Pressione F5 para executar o seu projeto.

2. Confirme que o primeiro registro aparece nas células A1 e B1.

3. Clique no botão de > (Button3) e confirme que o registro a seguir aparece na célula A1 e B1.

4. Clique nos outros botões de rolagem para confirmar que o registro foi alterado como esperado.

Próximas etapas

Este passo-a-passo mostra os conceitos básicos de associação de um intervalo nomeado a um campo em um banco de dados.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.

• Associar células às várias colunas em uma tabela, em vez a um campo.Para obter mais informações, consulte Passo a passo: Ligação de dados complexa em um projeto de nível de documento.

• Use um controle de BindingNavigator para percorrer os registros.Para obter mais informações, consulte Como: navegar em dados com o controle BindingNavigator do Windows Forms.

Consulte também

Tarefas

Passo a passo: Ligação de dados complexa 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