Partilhar via

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

  • Artigo

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:

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 Criando Aplicativos Baseados no Windows.

    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 para um banco de dados.

Conceitos

Visão geral do TableAdapter

Vinculação de controles do Windows Forms a dados em Visual Studio

Controles de vinculação de dados de Visual Studio

Outros recursos

Conectando-se a Dados no Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo

Editar dados no seu aplicativo

Validando Dados

Salvando dados