Instruções passo a passo: salvando dados em um banco de dados (tabela única)

Artigo
08/17/2015

Um dos cenários mais comuns no desenvolvimento de aplicativos é exibir dados de um formulário em um aplicativo do Windows, editar e enviá-los atualizados de volta para o banco de dados. Esse 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 no banco de dados. Este exemplo usa a tabela Customers do banco de dados de exemplo Northwind.

Você pode salvar os dados em seu aplicativo de volta no banco de dados chamando o método Update de um TableAdapter. Quando você arrasta itens da janela Fontes de Dados, o código para salvar os dados é automaticamente adicionado para a primeira tabela arrastada para um formulário. Qualquer tabela adicional adicionada a um formulário exige a adição manual de qualquer código necessário para salvar dados. Para obter informações sobre como salvar dados de mais de uma tabela, consulte Instruções 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 de Aplicativo do Windows.
Criando e configurando uma fonte de dados no aplicativo com o Assistente para Configuração da Fonte de Dados.
Definir os controles dos itens na Janela Fontes de Dados. Para obter mais informações, consulte Como definir o controle a ser criado quando arrastado da janela Fontes de Dados.
Criando controles associados a dados arrastando itens da janela Fontes de Dados para o formulário.
Mudar alguns registros no conjunto de dados.
Adicionar código para enviar os dados atualizados no conjunto de dados de volta para o banco de dados.

Observação

As caixas de diálogo e os comandos de menu que você vê podem ser diferentes dos descritos na Ajuda, dependendo da sua edição ou das configurações ativas.Para alterar as configurações, escolha Importar e Exportar Configurações no menu Ferramentas.Para obter mais informações, consulte Customizing Development Settings in Visual Studio.

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 o aplicativo do Windows

A primeira etapa é criar um Aplicativo do Windows. A atribuição de um nome ao projeto é opcional nesta etapa, mas daremos um nome a ele porque pretendemos salvá-lo posteriormente.

Para criar o novo projeto de Aplicativo do Windows

No menu Arquivo, crie um novo projeto.
Nomeie o projeto UpdateSingleTableWalkthrough.
Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.

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

Criando a Fonte de Dados

Esta etapa cria uma fonte de dados a partir de um banco de dados Northwind usando o Assistente de Configuração de Fonte de Dados. 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 exemplo.

Para criar a fonte de dados

No menu Dados, clique em Mostrar Fontes de Dados.
Na janela Fontes de Dados, clique em Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.
Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.
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 abrir a caixa de diálogo Adicionar/Modificar Conexão.
Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.
Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.
Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.
Selecione a tabela Clientes e clique em Concluir.

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

Configurando os controles a serem criados

Neste passo a passo, os dados estarão em um layout Detalhes onde os dados são exibidos em controles individuais em vez do layout padrão DataGridView.

Para definir os controles para os itens na janela Fontes de Dados

Expanda o nó Clientes na janela Fontes de Dados.
Mude o controle da tabela Clientes para controles individuais, selecionando Detalhes da lista suspensa no nó Clientes. Para obter mais informações, consulte Como definir o controle a ser criado quando arrastado da janela Fontes de Dados.

Criando o formulário de associação de dados

Você pode criar controles de associação de dados arrastando itens da janela Fontes de Dados para um formulário.

Para criar controles de associação de dados no formulário

Arraste o nó principal Clientes da janela Fontes de Dados para Form1.

Os controles de associação de dados com rótulos descritivos são exibidos no formulário, juntamente com uma faixa de ferramentas (BindingNavigator) para registros de navegação. Um NorthwindDataSet, CustomersTableAdapter, BindingSource e BindingNavigator são exibidos na bandeja de componentes.

Mudando 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 Salvar do BindingNavigator é adicionado ao código do formulário para enviar atualizações para o banco de dados. Este procedimento muda o código para incluir o tratamento de erros dispondo a chamada de atualização em um bloco try-catch. Você pode mudar o código para atender às necessidades do seu aplicativo.

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

Clique duas vezes no botão Salvar no BindingNavigator para abrir o Editor de Códigos para o manipulador de eventos bindingNavigatorSaveItem_Click.

Substitua o código no manipulador de eventos para adicionar algum tratamento 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 nos dados de um ou mais registros.
Pressione o botão Salvar.
Confira os valores no banco de dados para verificar se as alterações foram salvas.

Próximas etapas

Dependendo dos requisitos de aplicativo, existem várias etapas que você talvez queira realizar após criar um formulário de associação de dados no aplicativo do Windows. 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 controles que exibem dados relacionados. Para obter mais informações, consulte Como exibir dados relacionados em um aplicativo dos 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.