Passo a passo: Salvando dados em um banco de dados (Single Table)

Artigo
02/25/2013

Uma dos cenários mais comuns no desenvolvimento de aplicativos é exibir dados em um formulário em um aplicativo do Windows, editar os dados e enviar os dados atualizados de volta para o banco de dados.Esta explicação passo a passo cria um formulário simples que exibe dados de uma única tabela em controles individuais.Você pode editar os dados nos controles e salvar as alterações novamente no banco de dados.Este exemplo usa a tabela Customers do banco de dados de exemplo Northwind.

Você pode salvar dados em seu aplicativo de volta para o banco de dados chamando o método Update de um TableAdapter.Quando você arrastar itens da janela Data Sources, código para salvar dados será automaticamente adicionado para a primeira tabela arrastada para um formulário.Quaisquer tabelas adicionais adicionadas a um formulário exigem a inclusão manual de código necessário para salvar dados.Para obter informações sobre como salvar dados de mais de uma tabela, consulte Passo a passo: Salvando dados em um banco de dados (várias tabelas).

As tarefas ilustradas neste passo a passo incluem:

Criando um novo projeto Windows Application.
Criando e configurando um fonte de dados no seu aplicativo com o Data Source Configuration Wizard.
Configurar os controles dos itens na Janela fontes de dados.Para obter mais informações, consulte Como: definir o controle a ser criado ao arrastar da janela Data Sources.
Criando controles com dados vinculados arrastando itens da janela Data Sources para seu formulário.
Modificação de alguns dos registros no dataset.
Adição de código para enviar os dados atualizados no dataset de volta para o banco de dados.

Observação
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu.Para obter mais informações, consulte Configurações de Visual Studio.

Pré-requisitos

A fim de concluir este explicação passo a passo, será necessário:

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

Criando o aplicativo Windows

A primeira etapa é criar um Windows Application.Atribuir um nome para o projeto é opcional nesta etapa mas nós lhe daremos um nome porque planejamos salvá-lo posteriormente.

Para criar o novo projeto do Windows Application

No menu File, crie um novo projeto.
Nomeie o projeto UpdateSingleTableWalkthrough.
Selecione Windows Application e clique em OK.Para obter mais informações, consulte Desenvolvendo aplicativos clientes.

O projeto UpdateSingleTableWalkthrough é criado e adicionado ao Solution Explorer.

Criando o DataSet

Essa etapa cria uma fonte de dados do banco de dados Northwind usando o Data Source Configuration Wizard.Você deve ter acesso ao banco de dados de exemplo Northwind para concluir o assistente.Para obter informações sobre como configurar o banco de dados de exemplo Northwind, consulte Como: instalar bancos de dados de amostra.

Para criar o DataSet

No menu Data, clique em Show Data Sources.
Na janela Data Sources, clique em Add New Data Source para iniciar o Data Source Configuration Wizard.
Selecione Database na página Choose a Data Source Type, e clique Next.
Na página Choose your Data Connection siga um destes procedimentos:
- Se uma conexão de dados para o banco de dados de exemplo Northwind estiver disponível na lista drop-down, selecione-o.
  
  - ou -
- Selecione New Connection para abrir a caixa de diálogo Add/Modify Connection.Para obter mais informações, consulte Adicionar/modificar a caixa de diálogo de conexão (geral).
Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.
Clique Next na página Save connection string to the Application Configuration file.
Expanda o nó Tables na página Choose your Database Objects.
Selecione a tabela Customers, e clique Finish.

O NorthwindDataSet é adicionado ao seu projeto e a tabela Customers aparece na janela Data Sources.

Definindo os controles a serem criados

Nessa explicação passo a passo os dados estarão em um layout Details onde dados são exibidos em controles individuais em vez do layout DataGridView padrão.

Para definir os controles para os itens na janela Data Sources

Expanda o nó Customers na janela Data Sources.
Altere o controle para a tabela Customers para controles individuais, selecionando Details na lista suspensa no nó Customers.Para obter mais informações, consulte Como: definir o controle a ser criado ao arrastar da janela Data Sources.

Criando o formulário vinculado a dados

Você pode criar os controles com dados vinculados, arrastando itens da janela Data Sources para seu formulário.

Para criar controles vinculado a dados no formulário

Arraste o nó principal Customers da janela Data Sources no Form1.

Controles vinculados a dados com rótulos descritivos aparecem no formulário, juntamente com uma faixa de ferramenta (BindingNavigator) para navegação em registros.Um NorthwindDataSet,CustomersTableAdapter, BindingSource e BindingNavigator aparecem na bandeja de componentes.

Modificando o Código para Atualizar o Banco de Dados

Você pode atualizar o banco de dados chamando o método Update do CustomersTableAdapter.Por padrão, um manipulador de eventos para o botão Save do BindingNavigator é adicionado ao código do formulário para enviar atualizações ao banco de dados.Este procedimento modifica o código para incluir manipulação de erros amarrando a chamada de atualização em um bloco try-catch.Você pode modificar o código para atender às necessidades do seu aplicativo.

Para adicionar lógica de atualização para o aplicativo

Clique duas vezes no botão na Save em BindingNavigator para abrir o Code Editor para o manipulador de eventos bindingNavigatorSaveItem_Click.

Substitua o código no manipulador de eventos para adicionar alguns tratamentos de erros.O código deve se parecer com o seguinte:

Try
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
    MsgBox("Update successful")

Catch ex As Exception
    MsgBox("Update failed")
End Try

try
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.customersTableAdapter.Update(this.northwindDataSet.Customers);
    MessageBox.Show("Update successful");
}
catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

Testando o aplicativo

Para testar o aplicativo

Pressione F5.
Faça algumas alterações em dados de um ou mais registros.
Pressione o botão Save.
Verifique os valores no banco de dados para verificar se as alterações foram salvas.

Próximas etapas

Dependendo dos seus requisitos de aplicativo há várias etapas que você pode desejar executar após criar um formulário vinculado a dados no seu aplicativo do Windows.Alguns aprimoramentos que você poderia fazer a essa explicação passo a passo incluem:

Adicionar funcionalidade de pesquisa ao formulário.Para obter mais informações, consulte Como: adicionar uma consulta com parâmetros para um aplicativo do Windows Forms.
Adicionando controles que exibem dados relacionados.Para obter mais informações, consulte Como: exibir dados relacionados em um aplicativo do Windows Forms.
Editando a fonte de dados para adicionar ou remover objetos de banco de dados.Para obter mais informações, consulte Como: editar um conjunto de dados..