Instruções passo a passo: salvando dados com os métodos DBDirect TableAdapter

Este passo a passo fornece instruções detalhadas para a execução de instruções SQL diretamente em um banco de dados usando os métodos DBDirect de um TableAdapter. Os métodos DBDirect de um TableAdapter fornecem um bom nível de controle sobre as atualizações do seu banco de dados. Com eles, você pode executar instruções e procedimentos armazenados específicos de SQL chamando os métodos individuais Insert Update e Delete, conforme a necessidade do seu aplicativo (ao contrário do método sobrecarregado Update, que executa instruções UPDATE, INSERT e DELETE em apenas uma chamada).

Durante este passo a passo, você aprenderá a:

• Criar um novo Aplicativo do Windows.

• Criar e configurar um conjunto de dados com o Assistente para Configuração da Fonte de Dados.

• Selecionar o controle a ser criado no formulário ao arrastar itens da janela Fontes de Dados. Para obter mais informações, consulte Como definir o controle a ser criado quando arrastado da janela Fontes de Dados.

• Cria controles de associação de dados arrastando itens da janela Fontes de Dados para um formulário.

• Adicionar métodos para acessar diretamente o banco de dados e executar inserções, atualizações e exclusões diretamente no banco de dados.

Pré-requisitos

Para concluir este passo a passo, você precisará de:

• Acesso ao banco de dados de exemplo Northwind. Para obter mais informações, consulte Como instalar bancos de dados de exemplo.

Criando um aplicativo do Windows

A primeira etapa é criar um Aplicativo do Windows.

Para criar o novo projeto do Windows

1. No Visual Studio, no menu Arquivo, crie um novo Projeto.

2. Nomeie o projeto TableAdapterDbDirectMethodsWalkthrough.

3. Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.

   O projeto TableAdapterDbDirectMethodsWalkthrough é criado e adicionado ao Gerenciador de Soluções.

Criando uma fonte de dados a partir de seu banco de dados

Esta etapa usa o Assistente de Configuração de Fonte de Dados para criar uma fonte de dados com base na tabela Region no banco de dados de exemplo Northwind. É preciso ter acesso ao banco de dados de exemplo Northwind para criar a conexão. Para obter informações sobre como configurar o banco de dados de exemplo Northwind, consulte Como instalar bancos de dados de exemplo.

Para criar a fonte de dados

1. No menu Dados, clique em Mostrar Fontes de Dados.

2. Na janela Fontes de Dados, selecione Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.

3. Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.

4. Na página Escolha a Conexão de Dados, faça o seguinte:

   • Se uma conexão de dados com o banco de dados de exemplo Northwind estiver disponível na lista suspensa, selecione-o.

     -ou-

   • Selecione Nova Conexão para iniciar a caixa Adicionar/Modificar Conexão.

5. Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.

6. Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.

7. Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.

8. Selecione a tabela Region e clique em Concluir.

   O NorthwindDataSet é adicionado ao projeto e a tabela Region aparece na janela Fontes de Dados.

Adicionando controles ao formulário para exibir os dados

Crie controles de associação de dados arrastando itens da janela Fontes de Dados para seu formulário.

Para criar controles de associação de dados no Windows Form

• Arraste o nó Região principal da janela Fontes de Dados para o formulário.

  Um controle DataGridView e uma faixa de ferramentas (BindingNavigator) para navegação em registros são exibidos no formulário. Um NorthwindDataSet, RegionTableAdapter, BindingSource e BindingNavigator são exibidos na bandeja de componentes.

Para adicionar botões que chamam os métodos individuais DbDirect de um TableAdapter

1. Arraste três controles Button da Caixa de Ferramentas para Form1 (abaixo de RegionDataGridView).

2. Defina as propriedades Nome e Texto a seguir em cada botão.

   Nome	Texto
   InsertButton	Inserir
   UpdateButton	Atualizar
   DeleteButton	Excluir

Para adicionar código para inserir novos registros no banco de dados

1. Clique duas vezes em InsertButton para criar um manipulador de eventos para o evento Click e abrir o formulário no editor de códigos.

2. Substitua o manipulador de eventos InsertButton_Click pelo seguinte código:

   Private Sub InsertButton_Click() Handles InsertButton.Click
   
       Dim newRegionID As Integer = 5
       Dim newRegionDescription As String = "NorthEastern" 
   
       Try
           RegionTableAdapter1.Insert(newRegionID, newRegionDescription)
   
       Catch ex As Exception
           MessageBox.Show("Insert Failed")
       End Try
   
       RefreshDataset()
   End Sub 
   
   
   Private Sub RefreshDataset()
       Me.RegionTableAdapter1.Fill(Me.NorthwindDataSet1._Region)
   End Sub
   

   private void InsertButton_Click(object sender, EventArgs e)
   {
       Int32 newRegionID = 5;
       String newRegionDescription = "NorthEastern";
   
       try
       {
           regionTableAdapter1.Insert(newRegionID, newRegionDescription);
       }
       catch (Exception ex)
       {
           MessageBox.Show("Insert Failed");
       }
       RefreshDataset();
   }
   
   
   private void RefreshDataset()
   {
       this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
   }
   

Para adicionar código para atualizar registros no banco de dados

1. Clique duas vezes em UpdateButton para criar um manipulador de eventos para o evento Click e abrir o formulário no editor de códigos.

2. Substitua o manipulador de eventos UpdateButton_Click pelo seguinte código:

   Private Sub UpdateButton_Click() Handles UpdateButton.Click
   
       Dim newRegionID As Integer = 5
   
       Try
           RegionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern")
   
       Catch ex As Exception
           MessageBox.Show("Update Failed")
       End Try
   
       RefreshDataset()
   End Sub
   

   private void UpdateButton_Click(object sender, EventArgs e)
   {
       Int32 newRegionID = 5;
   
       try
       {
           regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
       }
       catch (Exception ex)
       {
           MessageBox.Show("Update Failed");
       }
       RefreshDataset();
   }
   

Para adicionar código excluir registros do banco de dados

1. Clique duas vezes em DeleteButton para criar um manipulador de eventos para o evento Click e abrir o formulário no editor de códigos.

2. Substitua o manipulador de eventos DeleteButton_Click pelo seguinte código:

   Private Sub DeleteButton_Click() Handles DeleteButton.Click
   
       Try
           RegionTableAdapter1.Delete(5, "Updated Region Description")
   
       Catch ex As Exception
           MessageBox.Show("Delete Failed")
       End Try
   
       RefreshDataset()
   End Sub
   

   private void DeleteButton_Click(object sender, EventArgs e)
   {
       try
       {
           regionTableAdapter1.Delete(5, "Updated Region Description");
       }
       catch (Exception ex)
       {
           MessageBox.Show("Delete Failed");
       }
       RefreshDataset();
   }
   

Executando o aplicativo

Para executar o aplicativo

• Pressione F5 para executar o aplicativo.

• Clique no botão Inserir e verifique se você vê o novo registro na grade.

• Clique no botão Atualizar e verifique se o registro foi atualizado na grade.

• Clique no botão Excluir e verifique se o registro foi removido da grade.

Próximas etapas

Dependendo dos requisitos do aplicativo, existem várias etapas que você talvez queira realizar após criar um formulário de associação de dados. Entre algumas das melhorias que você poderia fazer nessa explicação passo a passo estão:

• Adicionando funcionalidade de busca ao formulário. Para obter mais informações, consulte Como adicionar uma consulta parametrizada a um aplicativo dos Windows Forms.

• Adicionar tabelas ao conjunto de dados, selecionando Configurar DataSet com Assistente na janela Fontes de Dados. Você pode adicionar controles que exibem dados relacionados, arrastando os nós relacionados para o formulário. Para obter mais informações, consulte Como exibir dados relacionados em um aplicativo dos Windows Forms.

Consulte também

Tarefas

Como acessar de forma direta o banco de dados com um TableAdapter

Como criar consultas TableAdapter

Como salvar dados de um objeto em um banco de dados

Conceitos

Visão geral de TableAdapter

Associando controles dos Windows Forms a dados no Visual Studio

Preparando o aplicativo para receber dados

Buscando dados no aplicativo

Associando controles a dados no Visual Studio

Editando dados no aplicativo

Validando dados

Salvando dados

Outros recursos

Conectando a dados no Visual Studio