Demonstra Passo a passo: Ligação de dados simples 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 em um projeto de nível de documento. Um único campo de dados em um banco de dados de SQL Server é acoplado a um intervalo nomeado no Excel de Microsoft Office. Explicação passo a passo também mostra como adicionar controles que permitem que você percorra 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 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:

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

• Adicionar controles a uma planilha.

• Percorrer os 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 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

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 Meus Simple Data Binding, 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 meu Simple 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, clique em Show Data Sources sobre o dados menu.

   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 clientes tabela.

9. Click Finish.

O assistente adiciona o os clientes 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.

Para esta explicação, você precisa de dois intervalos nomeados e quatro botões na primeira planilha. Primeiro, adicione os dois intervalos nomeados da 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 dois intervalos nomeados

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

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

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

4. Selecione NamedRange na lista suspensa e, em seguida, arraste o CompanyName coluna à célula A1.

   A NamedRange controle chamado companyNameNamedRange é criado na célula A1. Ao mesmo tempo, um BindingSource chamado customersBindingSource, 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. Selecione o CustomerID coluna o Fontes de dados janela e clique na seta suspensa que aparece.

6. Clique em NamedRange na lista suspensa e, em seguida, arraste o CustomerID coluna à célula B1.

7. Outro NamedRange controle chamado customerIDNamedRange é criado na célula B1e vinculados a BindingSource.

Para adicionar os quatro 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. Adicione botões de mais três para as células a seguir nesta ordem, para que os nomes são conforme mostrado:

   Cell	(Name)
   B3	Button2
   C3	Button3
   D3	Button4

A próxima etapa é adicionar texto aos botões e no C# adicionar 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 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 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# 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);
   this.button3.Click += new EventHandler(button3_Click);
   this.button4.Click += new EventHandler(button4_Click);
   

Agora, adicione código para manipular a Click eventos dos botões para que o usuário pode procurar por meio de registros.

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 mover para o primeiro registro

• Adiciona um manipulador de eventos para o Click o evento da Button1 botão e, em seguida, 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

• Adiciona um manipulador de eventos para o Click o evento da Button2 botão e, em seguida, adicione o seguinte código para mover a posição de volta por um:

  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

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

  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 para o último registro

• Adiciona um manipulador de eventos para o Click o evento da Button4 botão e, em seguida, adicione o seguinte código para mover para 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();
  }
  

Testing the Application

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

Para testar a sua pasta de trabalho.

1. Pressione F5 para executar seu projeto.

2. Confirme se o primeiro registro é exibido nas células A1 e B1.

3. Clique na > (Button3) botão e confirme se o próximo registro aparece na célula A1 e B1.

4. Clique nos outros botões de rolagem para confirmar que o registro muda conforme o esperado.

Próximas etapas

Esta explicação passo a passo mostra noções básicas de um intervalo nomeado de ligação a um campo em um banco de dados. 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.

• Vincule células de várias colunas em uma tabela, em vez da um campo. For more information, see Demonstra Passo a passo: Ligação de dados complexa em um projeto de nível de documento.

• Use um BindingNavigator o controle para percorrer os registros. For more information, see Como: Navegar em Dados com o Controle BindingNavigator do Windows Forms.

Consulte também

Tarefas

Demonstra 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

Dados em soluções do Office