DataRow.RowState Property

 

Gets the current state of the row with regard to its relationship to the DataRowCollection.

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

Public ReadOnly Property RowState As DataRowState

Property Value

Type: System.Data.DataRowState

One of the DataRowState values.

The value of the RowState depends on two factors: the kind of operation has been performed on the row, and whether AcceptChanges has been called on the DataRow.

The following example first creates a new DataTable with one column, and then creates a single DataRow. As the DataRow is created, added, modified, and deleted, its RowState is printed.

Private Sub DemonstrateRowState()
    ' Run a function to create a DataTable with one column.
    Dim table As DataTable = MakeTable()
    Dim row As DataRow 

    ' Create a new DataRow.
    row = table.NewRow()
    ' Detached row.
    Console.WriteLine("New Row " & row.RowState)

    table.Rows.Add(row)
    ' New row.
    Console.WriteLine("AddRow " & row.RowState)

    table.AcceptChanges()
    ' Unchanged row.
    Console.WriteLine("AcceptChanges " & row.RowState)

    row("FirstName") = "Scott"
    ' Modified row.
    Console.WriteLine("Modified " & row.RowState)

    row.Delete()
    ' Deleted row.
    Console.WriteLine("Deleted " & row.RowState)
 End Sub

 Private Function MakeTable() As DataTable
    ' Make a simple table with one column.
    Dim table As DataTable = New DataTable("table")
    Dim dcFirstName As DataColumn = New DataColumn( _
        "FirstName", Type.GetType("System.String"))
    table.Columns.Add(dcFirstName)
    MakeTable = table
 End Function

.NET Framework
Available since 1.1
Return to top
Show: