Como: Atualizar dados usando um TableAdapter

Artigo
08/01/2011

Após os dados no seu DataSet terem sido modificados e validados, você provavelmente desejará enviar os dados atualizados de volta a um banco de dados. Para enviar os dados modificados a um banco de dados, você chama o método Update de um TableAdapter. O método Update do adaptador atualizará uma única tabela de dados e executará o comando correto (INSERT, UPDATE ou DELETE) com base no RowState de cada linha de dados na tabela. Quando você salva dados em tabelas relacionadas, o Visual Studio fornece um componente do TableAdapterManager que auxilia na execução salva na ordem correta com base nas restrições de chave externa definidas no banco de dados. Para obter mais informações, consulte Visão geral sobre atualização hierárquica.

Observação
Você deve colocar o código que chama o método Update do adaptador dentro de um bloco try/catch pois tentar atualizar uma fonte de dados com o conteúdo de um dataset pode causar erros.

O procedimento exato para atualizar uma fonte de dados pode variar dependendo de suas necessidades comerciais, mas seu aplicativo deve incluir as seguintes etapas:

Chamar o método Update do adaptador em um bloco try/catch.
Se uma exceção é detectada, localize a linha de dados que causou o erro. Para obter mais informações, consulte Como: Localizar linhas com erros.
Reconcilie o problema na linha de dados (programaticamente se você puder, ou apresentando a linha inválida para o usuário para modificação) e em seguida, tente novamente a atualização (HasErrors,GetErrors).

Salvar dados em um banco de dados

Chame o método Update de um TableAdapter, passando o nome da tabela de dados que contém os valores a serem gravados no banco de dados.

Para atualizar um banco de dados que possui um dataset usando um TableAdapter

Coloque o método Update do adaptador em um bloco try/catch. O exemplo a seguir mostra como tentar executar uma atualização de dentro de um bloco try/catch com o conteúdo da tabela Customers no NorthwindDataSet.

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

Atualizando duas tabelas relacionadas em um DataSet com um TableAdapter

Ao atualizar tabelas relacionadas em um DataSet, você deve atualizar na sequência apropriada a fim de reduzir a possibilidade de violar restrições de integridade referenciais. A ordem de execução do comando também seguirão os índices de DataRowCollection no DataSet. Para evitar que erros de integridade de dados sejam aumentados, a prática recomendada é atualizar o banco de dados na sequência a seguir:

Tabela filho: exclua registros.
Tabela pai: Inserir, atualizar e excluir registros.

Tabela filho: Inserir e atualizar registros.

Observação
Se você estiver atualizando duas ou mais tabelas relacionadas, então você deve incluir toda a lógica de atualização dentro de uma transação. Uma transação é um processo que garante que todas as alterações relacionadas ao banco de dados tenham êxito antes de confirmar as alterações. Para obter mais informações, consulte Transactions and Concurrency (ADO.NET).

Para atualizar duas tabelas relacionadas utilizando um TableAdapter

Crie três tabelas de dados temporário para conter os registros diferentes.
Chame o método Update para cada subconjunto de linhas de um bloco try/catch. Se ocorrerem erros de atualização, você deve discriminá-los e resolvê-los.
Confirmar as alterações para o banco de dados.

Descarte as tabelas de dados temporários para liberar os recursos.

O exemplo a seguir mostra como atualizar uma fonte de dados com um DataSet que contém tabelas relacionadas.

Private Sub UpdateDB()
    Dim deletedChildRecords As NorthwindDataSet.OrdersDataTable =
        CType(NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Deleted), NorthwindDataSet.OrdersDataTable)

    Dim newChildRecords As NorthwindDataSet.OrdersDataTable =
        CType(NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Added), NorthwindDataSet.OrdersDataTable)

    Dim modifiedChildRecords As NorthwindDataSet.OrdersDataTable =
        CType(NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Modified), NorthwindDataSet.OrdersDataTable)

    Try
        If deletedChildRecords IsNot Nothing Then
            OrdersTableAdapter.Update(deletedChildRecords)
        End If

        CustomersTableAdapter.Update(NorthwindDataSet.Customers)

        If newChildRecords IsNot Nothing Then
            OrdersTableAdapter.Update(newChildRecords)
        End If

        If modifiedChildRecords IsNot Nothing Then
            OrdersTableAdapter.Update(modifiedChildRecords)
        End If

        NorthwindDataSet.AcceptChanges()

    Catch ex As Exception
        MessageBox.Show("An error occurred during the update process")
        ' Add code to handle error here.

    Finally
        If deletedChildRecords IsNot Nothing Then
            deletedChildRecords.Dispose()
        End If

        If newChildRecords IsNot Nothing Then
            newChildRecords.Dispose()
        End If

        If modifiedChildRecords IsNot Nothing Then
            modifiedChildRecords.Dispose()
        End If

    End Try
End Sub

void UpdateDB()
{
    NorthwindDataSet.OrdersDataTable deletedChildRecords = 
        (NorthwindDataSet.OrdersDataTable)northwindDataSet.Orders.GetChanges(DataRowState.Deleted);

    NorthwindDataSet.OrdersDataTable newChildRecords = 
        (NorthwindDataSet.OrdersDataTable)northwindDataSet.Orders.GetChanges(DataRowState.Added);

    NorthwindDataSet.OrdersDataTable modifiedChildRecords = 
        (NorthwindDataSet.OrdersDataTable)northwindDataSet.Orders.GetChanges(DataRowState.Modified);

    try
    {
        if (deletedChildRecords != null)
        {
            ordersTableAdapter.Update(deletedChildRecords);
        }

        customersTableAdapter.Update(northwindDataSet.Customers);

        if (newChildRecords != null)
        {
            ordersTableAdapter.Update(newChildRecords);
        }

        if (modifiedChildRecords != null)
        {
            ordersTableAdapter.Update(modifiedChildRecords);
        }

        northwindDataSet.AcceptChanges();
    }

    catch (Exception ex)
    {
        MessageBox.Show("An error occurred during the update process");
        // Add code to handle error here.
    }

    finally
    {
        if (deletedChildRecords != null)
        {
            deletedChildRecords.Dispose();
        }
        if (newChildRecords != null)
        {
            newChildRecords.Dispose();
        }
        if (modifiedChildRecords != null)
        {
            modifiedChildRecords.Dispose();
        }
    }
}