DataRowCollection.Remove(DataRow) Methode

Definition

Entfernt den angegebenen DataRow aus der Auflistung.Removes the specified DataRow from the collection.

public:
 void Remove(System::Data::DataRow ^ row);
public void Remove (System.Data.DataRow row);
member this.Remove : System.Data.DataRow -> unit
Public Sub Remove (row As DataRow)

Parameter

row
DataRow

Das zu entfernende DataRow-Element.The DataRow to remove.

Beispiele

Im folgenden Beispiel wird die Remove-Methode verwendet, um eine gefundene Zeile in einem DataRowCollection-Objekt zu löschen.The following example uses the Remove method to delete a found row in a DataRowCollection object. Im Beispiel wird zuerst die Contains-Methode verwendet, um zu bestimmen, ob die Zeilen Auflistung eine Zeile enthält.The example first uses the Contains method to determine whether the rows collection contains a row. Wenn dies der Fall ist, wird die Find-Methode verwendet, um die jeweilige Zeile zu finden, und die Remove-Methode wird dann verwendet, um die Zeile zu entfernen.If it does, the Find method is used to find the specific row, and the Remove method is then used to remove the row.

Private Sub RemoveFoundRow(ByVal table As DataTable)
    Dim rowCollection As DataRowCollection = table.Rows

    ' Test to see if the collection contains the value.
    If rowCollection.Contains(TextBox1.Text) Then
        Dim foundRow As DataRow = rowCollection.Find(TextBox1.Text)
        rowCollection.Remove(foundRow)
        Console.WriteLine("Row Deleted")
    Else
        Console.WriteLine("No such row found.")
    End If
 End Sub

Hinweise

Wenn eine Zeile entfernt wird, gehen alle Daten in dieser Zeile verloren.When a row is removed, all data in that row is lost. Sie können auch die Delete-Methode der DataRow-Klasse aufzurufen, um eine Zeile zum Entfernen zu markieren.You can also call the Delete method of the DataRow class to just mark a row for removal. Das Aufrufen von Remove ist identisch mit dem Aufrufen von Delete und dem anschließenden Aufrufen von AcceptChanges.Calling Remove is the same as calling Delete and then calling AcceptChanges.

beim Durchlaufen eines DataRowCollection Objekts sollte Remove nicht in einer foreach-Schleife aufgerufen werden.Remove should not be called in a foreach loop while iterating through a DataRowCollection object. Remove ändert den Status der Auflistung.Remove modifies the state of the collection.

Sie können auch die Clear-Methode verwenden, um alle Elemente der Auflistung gleichzeitig zu entfernen.You can also use the Clear method to remove all members of the collection at one time.

Gilt für:

Siehe auch