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)

[1] [2]  下一页