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

Определение

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

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

DataRowVersion.cs

Описывает версию DataRow.

public enum class DataRowVersion

public enum DataRowVersion

type DataRowVersion = 

Public Enum DataRowVersion

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

Object

ValueType

Enum

DataRowVersion

Поля

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

Примеры

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

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 используются при получении значения, найденного в DataRow использовании Item[] или GetChildRows объекте DataRow .

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

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

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

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

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

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

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

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

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