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

  • Artigo

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:

ObservaçãoObservaçã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:

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

  1. No menu File, crie um novo projeto.

  2. Nomeie o projeto UpdateSingleTableWalkthrough.

  3. 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

  1. No menu Data, clique em Show Data Sources.

  2. Na janela Data Sources, clique em Add New Data Source para iniciar o Data Source Configuration Wizard.

  3. Selecione Database na página Choose a Data Source Type, e clique Next.

  4. 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).

  5. Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.

  6. Clique Next na página Save connection string to the Application Configuration file.

  7. Expanda o nó Tables na página Choose your Database Objects.

  8. 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

  1. Expanda o nó Customers na janela Data Sources.

  2. 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

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

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

  2. 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

  1. Pressione F5.

  2. Faça algumas alterações em dados de um ou mais registros.

  3. Pressione o botão Save.

  4. 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:

Consulte também

Conceitos

Novidades para desenvolvimento de aplicativos de dados no Visual Studio 2012

Vinculando controles do Windows Forms a dados em Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo.

Controles de vinculação de dados de Visual Studio

Edição de dados em seu aplicativo.

Validação de dados

Salvar dados

Outros recursos

Explicações passo a passo de dados

Connecting to Data in Visual Studio