This documentation is archived and is not being maintained.

DataRowCollection.Remove Method

Removes the specified DataRow from the collection.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

public void Remove (
	DataRow row
)
public void Remove (
	DataRow row
)
public function Remove (
	row : DataRow
)
Not applicable.

Parameters

row

The DataRow to remove.

When a row is removed, all data in that row is lost. You can also call the Delete method of the DataRow class to just mark a row for removal. Calling Remove is the same as calling Delete and then calling AcceptChanges.

You can also use the Clear method to remove all members of the collection at one time.

The following example uses the Remove method to delete a found row in a DataRowCollection object. The example first uses the Contains method to determine whether the rows collection contains a row. 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

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0
Show: