.NET Framework Class Library
DataRowCollection..::.Remove Method

Removes the specified DataRow from the collection.

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)
Syntax

Visual Basic (Declaration)
Public Sub Remove ( _
    row As DataRow _
)
Visual Basic (Usage)
Dim instance As DataRowCollection
Dim row As DataRow

instance.Remove(row)
C#
public void Remove(
    DataRow row
)
Visual C++
public:
void Remove(
    DataRow^ row
)
JScript
public function Remove(
    row : DataRow
)

Parameters

row
Type: System.Data..::.DataRow
The DataRow to remove.
Remarks

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.

Examples

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.

Visual Basic
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
Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0
See Also

Reference

Tags :


Page view tracker