Demonstra Passo a passo: Salvando dados a um banco de dados (Single tabela)

  • 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 Demonstra Passo a passo: Salvando dados a um banco de dados (Multiple Tables).

Tarefas ilustradas nesta explicação passo a passo incluem:

Observação:

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do 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 Criando Aplicativos Baseados no Windows.

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

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 Conexão Caixa de diálogo Box (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: conjunto o controle to be Created when Dragging from the dados Sources janela.

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

O que Há de Novo em Dados

Exibindo visão geral de dados

Outros recursos

Explicações Passo a passo sobre Dados

Conectando-se a Dados no Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo

Exibindo dados em formulários em aplicativos do Windows

Editar dados no seu aplicativo

Validando Dados

Salvando dados