DataRow.Delete DataRow.Delete DataRow.Delete DataRow.Delete Method

Definição

Exclui o DataRow.Deletes the DataRow.

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

Exceções

Exemplos

O exemplo a seguir cria um simples DataTable com duas colunas e dez linhas.The following example creates a simple DataTable with two columns and ten rows. Depois de excluir vários DataRow itens com o Delete método, uma das linhas é não excluído 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

Comentários

Se o RowState da linha é adicionada, o RowState se torna Detached e a linha é removida da tabela quando você chama 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 de usar o Delete método em um existente DataRow.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, o DataRow é removido 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 DataRowCollection objeto.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 excluída invocando RejectChanges.A deleted row can be undeleted by invoking RejectChanges.

Observação

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

Aplica-se a

Veja também