Compartilhar via


Passo a passo: Salvando dados com os métodos DBDirect

Esta explicação 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 fino 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 chamando os métodos individuais Insert, Update, and Delete conforme a necessidade do seu aplicativo (em oposição ao sobrecarregado método Update que executa as instruções UPDATE, INSERT, e DELETE todas em uma chamada).

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

  • Criar um novo Windows Application.

  • Criar e configurar um DataSet com o Data Source Configuration Wizard.

  • Selecione o controle a ser criado no formulário ao arrastar itens a partir da janela Data Sources.Para obter mais informações, consulte Como: definir o controle a ser criado ao arrastar da janela Data Sources.

  • Criar um formulário vinculado a dados, arrastando itens da janela Data Sources para o formulário.

  • Adicionar métodos para acessar o banco de dados e executar inserções, atualizações e exclusões diretamente no banco de dados.

Pré-requisitos

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

Criando um Aplicativo Windows

A primeira etapa é criar um Windows Application.

Para criar o novo projeto Windows

  1. No Visual Studio, a partir do menu File, crie um novo Project.

  2. Nome do projeto TableAdapterDbDirectMethodsWalkthrough.

  3. Selecione Windows Application e clique em OK.Para obter mais informações, consulte Desenvolvendo aplicativos clientes.

    O projeto TableAdapterDbDirectMethodsWalkthrough é criado e adicionado ao Solution Explorer.

Crie uma fonte de dados no seu banco de dados

Esse passo usa o Data Source Configuration Wizard para criar uma fonte de dados com base na tabela Region no banco de dados de exemplo Northwind.Você deve ter acesso ao banco de dados de exemplos 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 amostra.

Para criar o DataSet

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

  2. Na janela Data Sources, selecione 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 iniciar a caixa 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 Region, e clique em Finish.

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

Adicionar controles ao formulário para exibir os dados

Crie os controles com dados vinculados, arrastando itens da janela Data Sources para seu formulário.

Para criar dados acoplados ao controles no Windows Form

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

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

  2. Defina as seguintes propriedades Name e Text em cada botão.

    Nome

    Texto

    InsertButton

    Inserir

    UpdateButton

    Update

    DeleteButton

    Excluir

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

  1. Clique duas vezes em InsertButton para criar um manipulador de eventos para o evento Click e abrir o seu formulário no Editor de Código.

  2. Substitua o manipulador de eventos InsertButton_Click pelo código a seguir:

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

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

  1. Clique duas vezes em UpdateButton para criar um manipulador de eventos para o evento Click e abrir o formulário no Editor de Código.

  2. Substitua o manipulador de eventos UpdateButton_Click pelo código a seguir:

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

Para adicionar o código para excluir registros do banco de dados

  1. Clique duas vezes em DeleteButton para criar um manipulador de eventos para o evento Click e abrir o formulário no Editor de Código.

  2. Substitua o manipulador de eventos DeleteButton_Click pelo código a seguir:

    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
    
    private void DeleteButton_Click(object sender, EventArgs e)
    {
        try
        {
            regionTableAdapter1.Delete(5, "Updated Region Description");
        }
        catch (Exception ex)
        {
            MessageBox.Show("Delete Failed");
        }
        RefreshDataset();
    }
    

Executando o aplicativo

Para executar o aplicativo

  • Pressione F5 para executar o aplicativo.

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

  • Clique no botão Update e verifique se o registro é atualizado na grade.

  • Clique no botão Delete e verifique se o registro foi removido da grade.

Próximas etapas

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

Consulte também

Tarefas

Como: acessar diretamente o banco de dados com um TableAdapter

Como: criar consultas TableAdapter

Como: salvar dados de um objeto em um banco de dados

Conceitos

Visão geral do TableAdapter

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

Connecting to Data in Visual Studio