DataTable.GetChanges Método

  • Referência

Definição

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Obtém uma cópia do DataTable que contém todas as alterações feitas nele desde que foi carregado pela última vez ou desde que AcceptChanges() foi chamado.

Sobrecargas

GetChanges()

Obtém uma cópia do DataTable que contém todas as alterações feitas nele desde que ele foi carregado ou que o AcceptChanges() foi chamado pela última vez.
GetChanges(DataRowState)

Obtém uma cópia do DataTable que contém todas as alterações feitas desde o último carregamento ou desde que AcceptChanges() foi chamado, filtrado por DataRowState.

GetChanges()

Origem:
DataTable.cs
Origem:
DataTable.cs
Origem:
DataTable.cs

Obtém uma cópia do DataTable que contém todas as alterações feitas nele desde que ele foi carregado ou que o AcceptChanges() foi chamado pela última vez.

public:
 System::Data::DataTable ^ GetChanges();
public System.Data.DataTable? GetChanges ();
public System.Data.DataTable GetChanges ();
member this.GetChanges : unit -> System.Data.DataTable
Public Function GetChanges () As DataTable

Retornos

DataTable

Uma cópia das alterações neste DataTable ou null se nenhuma alteração foi encontrada.

Exemplos

private void UpdateDataTable(DataTable table,
    OleDbDataAdapter myDataAdapter)
{
    DataTable xDataTable = table.GetChanges();

    // Check the DataTable for errors.
    if (xDataTable.HasErrors)
    {
        // Insert code to resolve errors.
    }

    // After fixing errors, update the database with the DataAdapter
    myDataAdapter.Update(xDataTable);
}

Private Sub UpdateDataTable(table As DataTable, _
    myDataAdapter As OleDbDataAdapter)

    Dim xDataTable As DataTable = table.GetChanges()

    ' Check the DataTable for errors.
    If xDataTable.HasErrors Then
        ' Insert code to resolve errors.
    End If

    ' After fixing errors, update the database with the DataAdapter 
    myDataAdapter.Update(xDataTable)
End Sub

Comentários

Cria um novo DataSet que contém uma cópia de todas as linhas no original DataSet que têm alterações pendentes. As restrições de relação podem fazer com que linhas adicionais inalteradas sejam adicionadas ao novo DataSet se as linhas inalteradas contiverem chaves primárias correspondentes a chaves estrangeiras nas linhas alteradas. O método retornará null (Nothing no Visual Basic) se não houver linhas no original DataSet com alterações pendentes.

Confira também

Aplica-se a

GetChanges(DataRowState)

Origem:
DataTable.cs
Origem:
DataTable.cs
Origem:
DataTable.cs

Obtém uma cópia do DataTable que contém todas as alterações feitas desde o último carregamento ou desde que AcceptChanges() foi chamado, filtrado por DataRowState.

public:
 System::Data::DataTable ^ GetChanges(System::Data::DataRowState rowStates);
public System.Data.DataTable? GetChanges (System.Data.DataRowState rowStates);
public System.Data.DataTable GetChanges (System.Data.DataRowState rowStates);
member this.GetChanges : System.Data.DataRowState -> System.Data.DataTable
Public Function GetChanges (rowStates As DataRowState) As DataTable

Parâmetros

rowStates
DataRowState

Um dos valores de DataRowState.

Retornos

DataTable

Uma cópia filtrada do DataTable que pode ter ações executadas nela e, mais tarde, ser mesclada novamente ao DataTable usando Merge(DataSet). Se nenhuma linha do DataRowState desejado for encontrada, o método retornará null.

Exemplos

private void ProcessDeletes(DataTable table,
    OleDbDataAdapter adapter)
{
    DataTable changeTable = table.GetChanges(DataRowState.Deleted);

    // Check the DataTable for errors.
    if (changeTable.HasErrors)
    {
        // Insert code to resolve errors.
    }

    // After fixing errors, update the database with the DataAdapter
    adapter.Update(changeTable);
}

Private Sub ProcessDeletes(table As DataTable, _
    adapter As OleDbDataAdapter)

   Dim changeTable As DataTable = table.GetChanges(DataRowState.Deleted)

   ' Check the DataTable for errors.
   If table.HasErrors Then
      ' Insert code to resolve errors.
   End If

   ' After fixing errors, update the database with the DataAdapter 
   adapter.Update(changeTable)
End Sub

Comentários

O GetChanges método é usado para produzir um segundo DataTable objeto que contém apenas as alterações introduzidas no original. Use o rowStates argumento para especificar o tipo de alterações que o novo objeto deve incluir.

Restrições de relação podem fazer com que linhas pai inalteradas sejam incluídas.

Confira também

Aplica-se a