Compartilhar via

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

  • Artigo

 

Publicado: abril de 2016

Este passo a passo fornece instruções detalhadas para executar instruções SQL diretamente em um banco de dados usando os métodos DBDirect de um TableAdapter. Métodos DBDirect de um TableAdapter fornecem um bom nível de controle sobre as atualizações de banco de dados. Com eles você pode executar instruções SQL específicas e procedimentos armazenados por chamando individual Insert, Update, e Delete métodos conforme exigido pelo seu aplicativo (em vez de sobrecarregados Update método que executa as instruções UPDATE, INSERT e DELETE todas em uma chamada).

Durante essa explicação passo a passo, você aprenderá como:

Pré-requisitos

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

Criando um aplicativo do Windows

A primeira etapa é criar um Windows Application.

Para criar o novo projeto do Windows

  1. No Visual Studio, do arquivo menu, crie um novo projeto.

  2. Nomeie o projeto TableAdapterDbDirectMethodsWalkthrough.

  3. Selecione Windows Application e clique em OK. Para obter mais informações, consulte Aplicativos cliente.

    O TableAdapterDbDirectMethodsWalkthrough projeto é criado e adicionado ao Solution Explorer.

Criando uma fonte de dados do banco de dados

Esta etapa usa o Data Source Configuration Wizard para criar uma fonte de dados com base no Region tabela no banco de dados de exemplo Northwind. Você deve 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. Sobre o dados menu, clique em Show Data Sources.

  2. No fontes de dados janela, selecione Add New Data Source para iniciar o Data Source Configuration Wizard.

  3. Selecione banco de dados sobre o Escolher um tipo de fonte de dados página e, em seguida, clique em próximo.

  4. Sobre o Escolha sua conexão de dados página faça o seguinte:

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

      - ou -

    • Selecione nova conexão para iniciar o Adicionar/Modificar conexão caixa de diálogo.

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

  6. Clique em próximo sobre o Salvar cadeia de conexão no arquivo de configuração do aplicativo página.

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

  8. Selecione o Region da tabela e, em seguida, clique em Concluir.

    O NorthwindDataSet é adicionado ao seu projeto e o Region tabela aparece no fontes de dados janela.

Adicionando controles ao formulário para exibir os dados

Criar os controles associados a dados arrastando itens do fontes de dados window para seu formulário.

Para criar dados vinculados a controles no Windows Form

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

  1. Arraste três Button controles do Toolbox para Form1 (abaixo de RegionDataGridView).

  2. Defina o seguinte nome e texto propriedades em cada botão.

    Nome Texto
    InsertButton Inserir
    UpdateButton Atualização
    DeleteButton Excluir

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

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

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

            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);
        }

        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

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

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

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

            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();
        }

        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

Para adicionar código excluir registros do banco de dados

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

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

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

        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

Executando o aplicativo

Para executar o aplicativo

  • Pressione F5 para executar o aplicativo.

  • Clique o Inserir botão e verifique se o novo registro aparece na grade.

  • Clique o atualização botão e verifique se o registro é atualizado na grade.

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

Próximas etapas

Dependendo dos requisitos de aplicativo, há várias etapas que você pode desejar executar após criar um formulário de associação de dados. Alguns aprimoramentos que você poderia fazer neste passo a passo incluem:

Consulte também

Salvar dados no banco de dados