DataRowVersion Перечисление

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Описание версии DataRow.

public enum class DataRowVersion

public enum DataRowVersion

type DataRowVersion = 

Public Enum DataRowVersion

Наследование

Object

ValueType

Enum

DataRowVersion

Поля

Current	512	Строка содержит текущие значения.
Default	1536	Версия DataRowState по умолчанию. Для значения DataRowStateAdded, Modified или Deleted по умолчанию используется версия Current. Для значения DataRowStateDetached используется версия Proposed.
Original	256	Строка содержит исходные значения.
Proposed	1024	Строка содержит предложенное значение.

Примеры

В следующем примере проверяется DataRowVersion перед вызовом DataRowAcceptChanges метода .

private static void CheckVersionBeforeAccept()
{
    //Run a function to create a DataTable with one column.
    DataTable dataTable = MakeTable();

    DataRow dataRow = dataTable.NewRow();
    dataRow["FirstName"] = "Marcy";
    dataTable.Rows.Add(dataRow);

    dataRow.BeginEdit();
    // Edit data but keep the same value.
    dataRow[0] = "Marcy";
    // Uncomment the following line to add a new value.
    // dataRow(0) = "Richard"
    Console.WriteLine(string.Format("FirstName {0}", dataRow[0]));

    // Compare the proposed version with the current.
    if (dataRow.HasVersion(DataRowVersion.Proposed)) {
        if (object.ReferenceEquals(dataRow[0, DataRowVersion.Current], dataRow[0, DataRowVersion.Proposed])) {
            Console.WriteLine("The original and the proposed are the same.");
            dataRow.CancelEdit();
        } else {
            dataRow.AcceptChanges();
            Console.WriteLine("The original and the proposed are different.");
        }
    }
}

private static DataTable MakeTable()
{
    // Make a simple table with one column.
    DataTable dt = new DataTable("dataTable");
    DataColumn firstName = new DataColumn("FirstName", Type.GetType("System.String"));
    dt.Columns.Add(firstName);
    return dt;
}

Private Sub CheckVersionBeforeAccept()
    'Run a function to create a DataTable with one column.
    Dim dataTable As DataTable = MakeTable()

    Dim dataRow As DataRow = dataTable.NewRow()
    dataRow("FirstName") = "Marcy"
    dataTable.Rows.Add(dataRow)

    dataRow.BeginEdit()
    ' Edit data but keep the same value.
    dataRow(0) = "Marcy"
    ' Uncomment the following line to add a new value.
    ' dataRow(0) = "Richard"
    Console.WriteLine(String.Format("FirstName {0}", dataRow(0)))

    ' Compare the proposed version with the current.
    If dataRow.HasVersion(DataRowVersion.Proposed) Then
        If dataRow(0, DataRowVersion.Current) Is dataRow(0, DataRowVersion.Proposed) Then
            Console.WriteLine("The original and the proposed are the same.")
            dataRow.CancelEdit()
        Else
            dataRow.AcceptChanges()
            Console.WriteLine("The original and the proposed are different.")
        End If
    End If
End Sub

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

Комментарии

Значения DataRowVersion используются при извлечении значения, найденного в объекте DataRowGetChildRowsDataRow using Item[] или объекта .

Сообщает DataRowVersion , какая версия DataRow существует. Версии изменяются в следующих случаях:

• После вызова DataRow метода объекта BeginEdit при изменении значения становятся доступными Current значения и Proposed .

• После вызова DataRow метода Proposed объекта CancelEdit значение удаляется.

• После вызова DataRow метода объекта EndEdit предлагаемое значение становится значением Current .

• После вызова DataRow метода Original объекта AcceptChanges значение становится идентичным значению Current .

• После вызова DataTable метода Original объекта AcceptChanges значение становится идентичным значению Current .

• После вызова DataRow метода Proposed объекта RejectChanges значение удаляется, а версия становится Current.

См. также раздел

• AcceptChanges()
• BeginEdit()
• EndEdit()
• Item[Int32]
• RejectChanges()