DataRowVersion DataRowVersion DataRowVersion DataRowVersion Enum

Определение

Описание версии DataRow.Describes the version of a DataRow.

public enum class DataRowVersion
public enum DataRowVersion
type DataRowVersion = 
Public Enum DataRowVersion
Наследование
DataRowVersionDataRowVersionDataRowVersionDataRowVersion

Поля

Current Current Current Current 512

Строка содержит текущие значения.The row contains current values.

Default Default Default Default 1536

Версия DataRowState по умолчанию.The default version of DataRowState. Для значения DataRowState Added, Modified или Deleted по умолчанию используется версия Current.For a DataRowState value of Added, Modified or Deleted, the default version is Current. Для значения DataRowState Detached используется версия Proposed.For a DataRowState value of Detached, the version is Proposed.

Original Original Original Original 256

Строка содержит исходные значения.The row contains its original values.

Proposed Proposed Proposed Proposed 1024

Строка содержит предложенное значение.The row contains a proposed value.

Примеры

В следующем примере проверяется DataRowVersion DataRow перед вызовом AcceptChanges метода.The following example checks the DataRowVersion of a DataRow before invoking the AcceptChanges method.

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

Комментарии

Item[String, DataRowVersion] DataRow DataRow GetChildRows Значения используются при получении значения, найденного в с помощью или объекта. DataRowVersionThe DataRowVersion values are used when retrieving the value found in a DataRow using Item[String, DataRowVersion] or the GetChildRows of the DataRow object.

Сообщает, какая версия DataRow существует. DataRowVersionThe DataRowVersion informs you what version of a DataRow exists. Версии изменяются в следующих случаях.Versions change under the following circumstances:

  • DataRow После вызова BeginEdit метода объекта, если Current изменить значение, становятся доступными значения и Proposed .After calling the DataRow object's BeginEdit method, if you change the value, the Current and Proposed values become available.

  • После вызова DataRow CancelEdit метода объектазначениеудаляется.ProposedAfter calling the DataRow object's CancelEdit method, the Proposed value is deleted.

  • После вызова DataRow EndEdit метода объекта предложенное значение станет Current значением.After calling the DataRow object's EndEdit method, the Proposed value becomes the Current value.

  • DataRow После вызова AcceptChanges метода Current объекта значениебудетидентичнозначению.OriginalAfter calling the DataRow object's AcceptChanges method, the Original value becomes identical to the Current value.

  • DataTable После вызова AcceptChanges метода Current объекта значениебудетидентичнозначению.OriginalAfter calling the DataTable object's AcceptChanges method, the Original value becomes identical to the Current value.

  • DataRow После вызова RejectChanges метода Currentобъекта значение отбрасывается, а версия становится. ProposedAfter calling the DataRow object's RejectChanges method, the Proposed value is discarded, and the version becomes Current.

Применяется к

Дополнительно