DataRow构造
n Protected Friend Sub New(ByVal builder As DataRowBuilder)
DataRow 和 DataColumn 对象是 DataTable 的主要组件。使用 DataRow 对象及其属性和方法检索、评估、插入、删除和更新 DataTable 中的值。DataRowCollection 表示 DataTable 中的实际 DataRow 对象,DataColumnCollection 中包含用于描述 DataTable 的架构的 DataColumn 对象。使用重载的 Item 属性返回或设置 DataColumn 的值。
使用 HasVersion 和 IsNull 属性确定特定行值的状态,使用 RowState 属性确定行相对于它的父级 DataTable 的状态。
若要创建新的 DataRow,请使用 DataTable 对象的 NewRow 方法。创建新的 DataRow 之后,请使用 Add 方法将新的 DataRow 添加到 DataRowCollection 中。最后,调用 DataTable 对象的 AcceptChanges 方法以确认是否已添加。
您可通过调用 DataRowCollection 的 Remove 方法或调用 DataRow 对象的 Delete 方法,从 DataRowCollection 中删除 DataRow。Remove 方法将行从集合中移除。与此相反,Delete 标记要移除的 DataRow。在调用 AcceptChanges 方法时发生实际移除。通过调用 Delete,您可在实际删除行之前以编程方式检查哪些行被标记为移除。
DataRow的两个重要方法
n HasVersion方法
Public Function HasVersion(ByVal version As DataRowVersion) As Boolean
参数
1. version DataRowVersion 值之一,它指定行版本。
当使用 Item 或 DataRow 对象的 GetChildRows 检索在 DataRow 中找到的值时,使用 DataRowVersion 值。
DataRowVersion 向您通知存在 DataRow 的哪个版本。版本在以下情况下发生更改:
n 在调用 DataRow 对象的 BeginEdit 方法之后,如果更改该值,则 Current 和 Proposed 值变得可用。
n 在调用 DataRow 对象的 CancelEdit 方法之后,Proposed 值将被删除。
n 在调用 DataRow 对象的 EndEdit 方法之后,Proposed 值变成 Current 值。
n 在调用 DataRow 对象的 AcceptChanges 方法之后,Original 值变得与 Current 值相同。
n 在调用 DataTable 对象的 AcceptChanges 方法之后,Original 值变得与 Current 值相同。
n 在调用 DataRow 对象的 RejectChanges 之后,Proposed 值将被丢弃,版本变成 Current。
成员名称
说明
Current
该行中包含当前值。
Default
是 DataRowState 对当前行的默认版本。对于 Added、Modified 或 Current 的 DataRowState 值,默认版本是 Current。对于 Deleted 的 DataRowState,该版本是 Original。对于 Detached 的 DataRowState 值,该版本是 Proposed。
Original
该行中包含其原始值。
Proposed
该行中包含建议值。
示例
以下示例使用 HasVersion 方法确定列的当前值和建议值是否相同。如果相同,则取消编辑。否则,调用 AcceptChanges 方法以终止编辑。
Private Sub CheckVersionBeforeAccept()
Dim r As DataRow
Dim t As DataTable
' Assuming the DataGrid is bound to a DataTable.
t = CType(DataGrid1.DataSource, DataTable)
r = t.Rows(DataGrid1.CurrentCell.RowNumber)
r.BeginEdit
r(1) = Edit1.Text
If r.HasVersion(datarowversion.Proposed) Then
If r(1, DataRowVersion.Current) Is r(1, DataRowversion.Proposed) Then
MessageBox.Show("The original and the proposed are the same")
r.CancelEdit
Exit Sub
Else
r.AcceptChanges
End If
Else
MessageBox.Show("No new values proposed")
End If
End Sub