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

Artigo
02/25/2013

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:

Acesso ao banco de dados de exemplo Northwind.Para obter mais informações, consulte Como: instalar bancos de dados de amostra.

Criando um Aplicativo Windows

A primeira etapa é criar um Windows Application.

Para criar o novo projeto Windows

No Visual Studio, a partir do menu File, crie um novo Project.
Nome do projeto TableAdapterDbDirectMethodsWalkthrough.
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

No menu Data, clique em Show Data Sources.
Na janela Data Sources, selecione Add New Data Source para iniciar o Data Source Configuration Wizard.
Selecione Database na página Choose a Data Source Type, e clique Next.
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).
Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.
Clique Next na página Save connection string to the Application Configuration file.
Expanda o nó Tables na página Choose your Database Objects.
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

Arraste o nó principal Region da janela Data Sources para o formulário.

Um controle DataGridView e uma faixa de ferramenta (BindingNavigator) para navegação em registros aparecem no formulário.Um NorthwindDataSet, RegionTableAdapter, BindingSource e BindingNavigator aparecem na bandeja de componentes.

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

Arraste três controles Button do ToolBox para Form1 (abaixo de RegionDataGridView).
Defina as seguintes propriedades Name e Text em cada botão.

Nome

Texto

InsertButton

Inserir

UpdateButton

Update

DeleteButton

Excluir

Nome	Texto
InsertButton	Inserir
UpdateButton	Update
DeleteButton	Excluir

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

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.

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

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.

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

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.

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:

Adicionar funcionalidade de pesquisa ao formulário.Para obter mais informações, consulte Como: adicionar uma consulta com parâmetros para um aplicativo do Windows Forms.
Adicionar tabelas adicionais ao dataset, selecionando o Configure DataSet with Wizard dentro da janela Data Sources.Você pode adicionar controles que exibem dados relacionados, arrastando os nós relacionados para o formulário.Para obter mais informações, consulte Como: exibir dados relacionados em um aplicativo do Windows Forms.

Consulte também

Compartilhar via