DataRowVersion Enumeración

Definición

Describe la versión de DataRow.

public enum class DataRowVersion
public enum DataRowVersion
type DataRowVersion = 
Public Enum DataRowVersion
Herencia
DataRowVersion

Campos

Current 512

La fila contiene sus valores actuales.

Default 1536

Versión predeterminada de DataRowState. Para un valor de DataRowState igual a Added, Modified o Deleted, la versión predeterminada es Current. Para un valor DataRowState de Detached, la versión es Proposed.

Original 256

La fila contiene sus valores originales.

Proposed 1024

La fila contiene un valor propuesto.

Ejemplos

En el ejemplo siguiente se comprueba el DataRowVersion de un DataRow objeto antes de invocar el AcceptChanges método .

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

Comentarios

Los DataRowVersion valores se usan al recuperar el valor que se encuentra en un DataRow objeto using Item[] o del DataRowGetChildRows objeto .

DataRowVersion le informa de DataRow qué versión existe. Las versiones cambian en las siguientes circunstancias:

  • Después de llamar al DataRow método del BeginEdit objeto, si cambia el valor, los Current valores y Proposed estarán disponibles.

  • Después de llamar al DataRow método del CancelEdit objeto, se elimina el Proposed valor.

  • Después de llamar al DataRow método del EndEdit objeto, el valor Propuesto se convierte en el Current valor .

  • Después de llamar al DataRow método del AcceptChanges objeto, el Original valor se convierte en idéntico al Current valor .

  • Después de llamar al DataTable método del AcceptChanges objeto, el Original valor se convierte en idéntico al Current valor .

  • Después de llamar al DataRow método del RejectChanges objeto, se descarta el Proposed valor y la versión se convierte en Current.

Se aplica a

Consulte también