DataRow Class

Overview

The DataRow class provides row-level functionality in the POCO DataSet framework. It stores column values internally in a Dictionary<string, object?> and adds change tracking (DataRowState), baseline snapshot support (OriginalValues / HasOriginalValues), and a UI selection flag (Selected).

A row typically belongs to a DataTable and is created by calling IDataTable.AddNewRow. Once created, you can read or assign values by column name using the Item[string] indexer.

Namespace and Assembly

Namespace: PocoDataSet.Data
Assembly: PocoDataSet.Data.dll

Members

Properties

• DataRowState
  Allows you to get the state of a row but cannot be set directly by application code. State transitions are managed internally by the POCO DataSet framework based on row operations (Add, Modify, Delete, AcceptChanges, RejectChanges).
• HasOriginalValues
  Indicates whether a data row currently holds a snapshot of its original (baseline) values. This snapshot is created automatically by the framework when an unchanged row is modified for the first time, or when the Delete method is called.
• OriginalValues
  Provides read-only access to the baseline values of a data row, captured at the moment the row first transitions away from the Unchanged state.
• Selected
  Allows you to get or set a flag indicating whether a row is selected. This property is primarily intended for use in the presentation layer of applications. Typical use cases include UI selection, highlighting, or interaction state in data-bound controls such as grids, lists, or tree views. The Selected property does not affect the row’s DataRowState, change tracking, or persistence behavior. It is not considered part of the row’s data and is ignored by AcceptChanges, RejectChanges, and merge operations.
• Values
  The Values property returns a read-only view of the row current field values.

Methods

• AcceptChanges
  Accepts the row current values as the new baseline and sets the row state to Unchanged (when applicable).
  If the current state of the row is Detached or Unchanged, the AcceptChanges method does nothing.
  If the current state of the row is Deleted then AcceptChanges method throws an exception because accepting changes means the deleted row must be removed from the table it belongs to, but that action can be done at table level only.
  If the current state of the row is Added or Modified then the AcceptChanges method changes the row's state to Unchanged.
  For Added and Modified rows, AcceptChanges method discards any stored original-value snapshot and makes current values the baseline.
• ContainsKey
  Allows you to check whether a row contains a value for the specified column name. The ContainsKey method checks only for the presence of the specified column name in the row. It does not indicate whether the associated value is non-null.
• Delete
  Marks a row for deletion. The method changes the row state to Deleted and captures original values if they are not already captured.
• RejectChanges
  Reverts a row to its baseline (original) values captured by the framework. The method behaves differently depending on the current state of the row.
  If the current state of the row is Detached or Unchanged then RejectChanges method does nothing.
  If the current state of the row is Added, the RejectChanges method throws an exception because "reject changes" means added row needs to be removed from the table it was added to, but that action must be performed at table level.
  If the current state of the row is Deleted or Modified then the RejectChanges method restores row values from the snapshot if it exists and changes the row's state to Unchanged. If no snapshot exists, it still sets state to Unchanged and clears snapshot.
• TryGetOriginalValue
  Allows you to get the baseline (original) value of data field by column name from the row original-values snapshot, if such a snapshot exists.
• TryGetValue
  Allows you to get the current value of data field by column name. The method returns true when the row contains the specified data field, otherwise it returns false and outputs null.

Indexer

• Indexer
  Allows you to get or set the current value of a row data field by column name. This indexer provides convenient access to row values using array-like syntax. Reading a value using the indexer returns null if the specified column does not exist or if the stored value is null. Writing a value using the indexer updates the row value and may change the row’s DataRowState. If the row is in the Unchanged state, assigning a different value causes the framework to capture original values and mark the row as Modified.

 

Table of Content POCO DataSet PocoDataSet.Data

 

---

Business Process Programming in .Net
© 2004–2026 Laskarzhevsky Software Inc.
Unless otherwise noted, the content of this website is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0).
Code examples are provided under the MIT License.
You are free to share and adapt the material provided that appropriate credit is given and any modifications are clearly indicated.
The information provided on this website is for educational purposes only.
The author and publisher make no warranties regarding the completeness or suitability of the information and are not responsible for any damages resulting from its use.