行状态与行版本
更新：November 2007
ADO.NET 用行状态和行版本管理表中的行。行状态指示行的状态；行版本在修改行中存储的值时维护各个阶段的值，包括当前值、原始值和默认值。例如，在修改了行中的某列后，该行的行状态将为 Modified，并且有两个行版本：Current（包含行的当前值）和 Original（包含列修改前行的值）。
每个 DataRow 对象都具有 RowState 属性，您可以检查此属性来确定行的当前状态。下表提供了对每个 RowState 枚举值的简短说明。
RowState 值 |
说明 |
|---|---|
自上次调用 AcceptChanges 以来或由 DataAdapter.Fill 创建该行以来，没有进行任何更改。 |
|
已将该行添加到表中，但尚未调用 AcceptChanges。 |
|
已更改了行的某个元素。 |
|
已从表中删除该行，并且尚未调用 AcceptChanges。 |
|
该行不是任何 DataRowCollection 的一部分。新创建的行的 RowState 设置为 Detached。通过调用 Add 方法将新的 DataRow 添加到 DataRowCollection 后，RowState 属性的值设置为 Added。 将使用 Remove 方法，或使用 Delete 方法接着使用 AcceptChanges 方法从 DataRowCollection 中移除的行也设置为 Detached。 |
对 DataSet、DataTable 或 DataRow 调用 AcceptChanges 时，会移除行状态为 Deleted 的所有行。剩余行的行状态为 Unchanged，并且 Original 行版本中的值将被 Current 行版本值覆盖。调用 RejectChanges 时，会移除行状态为 Added 的所有行。剩余行的行状态为 Unchanged，并且 Current 行版本中的值将被 Original 行版本值覆盖。
通过列引用来传递 DataRowVersion 参数，您可以查看行的不同行版本，如下面的示例所示。
Dim custRow As DataRow = custTable.Rows(0)
Dim custID As String = custRow("CustomerID", DataRowVersion.Original).ToString()
DataRow custRow = custTable.Rows[0];
string custID = custRow["CustomerID", DataRowVersion.Original].ToString();
下表提供了对每个 DataRowVersion 枚举值的简短说明。
DataRowVersion 值 |
说明 |
|---|---|
行的当前值。如果行的 RowState 为 Deleted，则不存在此行版本。 |
|
特定行的默认行版本。Added、Modified 或 Unchanged 行的默认行版本是 Current。Deleted 行的默认行版本是 Original。Detached 行的默认行版本是 Proposed。 |
|
行的原始值。如果行的 RowState 为 Added，则不存在此行版本。 |
|
行的建议值。在对行进行编辑操作的过程中，或者对于不属于 DataRowCollection 的行，存在此行版本。 |
通过调用 HasVersion 方法并将 DataRowVersion 作为参数传递，您可以测试 DataRow 是否具有特定的行版本。例如，在调用 AcceptChanges 之前，DataRow.HasVersion(DataRowVersion.Original) 对新添加的行将返回 false。
下面的代码示例演示表中所有已删除行中的值。Deleted 行没有 Current 行版本，因此在访问列值时必须传递 DataRowVersion.Original。
Dim catTable As DataTable = catDS.Tables("Categories")
Dim delRows() As DataRow = catTable.Select(Nothing, Nothing, DataViewRowState.Deleted)
Console.WriteLine("Deleted rows:" & vbCrLf)
Dim catCol As DataColumn
Dim delRow As DataRow
For Each catCol In catTable.Columns
Console.Write(catCol.ColumnName & vbTab)
Next
Console.WriteLine()
For Each delRow In delRows
For Each catCol In catTable.Columns
Console.Write(delRow(catCol, DataRowVersion.Original) & vbTab)
Next
Console.WriteLine()
Next
DataTable catTable = catDS.Tables["Categories"];
DataRow[] delRows = catTable.Select(null, null, DataViewRowState.Deleted);
Console.WriteLine("Deleted rows:\n");
foreach (DataColumn catCol in catTable.Columns)
Console.Write(catCol.ColumnName + "\t");
Console.WriteLine();
foreach (DataRow delRow in delRows)
{
foreach (DataColumn catCol in catTable.Columns)
Console.Write(delRow[catCol, DataRowVersion.Original] + "\t");
Console.WriteLine();
}