DataRow.Delete Method

Definition

Exclui o DataRow.Deletes the DataRow.

public:
 void Delete();
public void Delete ();
member this.Delete : unit -> unit
Public Sub Delete ()

Exceptions

O DataRow já foi excluído.The DataRow has already been deleted.

Examples

O exemplo a seguir cria um DataTable simples com duas colunas e dez linhas.The following example creates a simple DataTable with two columns and ten rows. Depois de excluir vários itens de DataRow com o método Delete, uma das linhas é restaurada invocando RejectChanges.After deleting several DataRow items with the Delete method, one of the rows is undeleted by invoking RejectChanges.

private void DemonstrateDeleteRow()
{
    // Create a simple DataTable with two columns and ten rows.
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement=true;
    DataColumn itemColumn = new DataColumn("item",
        Type.GetType("System.String"));
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);

    // Add ten rows.
    DataRow newRow;

    for(int i = 0; i <10; i++)
    {
        newRow = table.NewRow();
        newRow["item"] = "Item " + i;
        table.Rows.Add(newRow);
    }
    table.AcceptChanges();

    DataRowCollection itemColumns = table.Rows;
    itemColumns[0].Delete();
    itemColumns[2].Delete();
    itemColumns[3].Delete();
    itemColumns[5].Delete();
    Console.WriteLine(itemColumns[3].RowState.ToString());

    // Reject changes on one deletion.
    itemColumns[3].RejectChanges();

    // Change the value of the column so it stands out.
    itemColumns[3]["item"] = "Deleted, Undeleted, Edited";

    // Accept changes on others.
    table.AcceptChanges();

    // Print the remaining row values.
    foreach(DataRow row in table.Rows)
    {
        Console.WriteLine(row[0] + "\table" + row[1]);
    }
}
 Private Sub DemonstrateDeleteRow()
     ' Create a simple DataTable with two columns and ten rows.
     Dim table As New DataTable("table")
     Dim idColumn As New DataColumn("id", Type.GetType("System.Int32"))
     idColumn.AutoIncrement = True
     Dim itemColumn As New DataColumn("item", Type.GetType("System.String"))
     table.Columns.Add(idColumn)
     table.Columns.Add(itemColumn)

     ' Add ten rows.
     Dim newRow As DataRow
     
     Dim i As Integer
     For i = 0 To 9
         newRow = table.NewRow()
         newRow("item") = "Item " & i.ToString()
         table.Rows.Add(newRow)
     Next i
     table.AcceptChanges()

     Dim itemColumns As DataRowCollection = table.Rows
     itemColumns(0).Delete()
     itemColumns(2).Delete()
     itemColumns(3).Delete()
     itemColumns(5).Delete()
     Console.WriteLine(itemColumns(3).RowState.ToString())

     ' Reject changes on one deletion.
     itemColumns(3).RejectChanges()

     ' Change the value of the column so it stands out.
     itemColumns(3)("item") = "Deleted, Undeleted, Edited"

     ' Accept changes on others.
     table.AcceptChanges()

     ' Print the remaining row values.
     Dim row As DataRow
     For Each row In  table.Rows
         Console.WriteLine(row(0).ToString() & ControlChars.Tab _
            & row(1).ToString())
     Next row
End Sub

Remarks

Se a RowState da linha for adicionada, a RowState se tornará Detached e a linha será removida da tabela quando você chamar AcceptChanges.If the RowState of the row is Added, the RowState becomes Detached and the row is removed from the table when you call AcceptChanges.

O RowState se torna Deleted depois que você usa o método Delete em um DataRowexistente.The RowState becomes Deleted after you use the Delete method on an existing DataRow. Ele permanece Deleted até que você chame AcceptChanges.It remains Deleted until you call AcceptChanges. Neste momento, a DataRow é removida da tabela.At this time, the DataRow is removed from the table.

Delete não deve ser chamado em um loop foreach durante a iteração por meio de um objeto DataRowCollection.Delete should not be called in a foreach loop while iterating through a DataRowCollection object. Delete modifica o estado da coleção.Delete modifies the state of the collection.

Uma linha excluída pode não ser excluída invocando RejectChanges.A deleted row can be undeleted by invoking RejectChanges.

Note

O método BeginEdit Suspende temporariamente RowChanging eventos, mas a operação de exclusão não.The BeginEdit method temporarily suspends RowChanging events, but the delete operation does not.

Applies to

See also