DataViewRowState DataViewRowState DataViewRowState DataViewRowState Enum

Definición

Describe la versión de datos de un DataRow.Describes the version of data in a DataRow.

Esta enumeración tiene el atributo FlagsAttribute, que permite una combinación bit a bit de sus valores de miembro.

public enum class DataViewRowState
[System.Flags]
public enum DataViewRowState
type DataViewRowState = 
Public Enum DataViewRowState
Herencia
DataViewRowStateDataViewRowStateDataViewRowStateDataViewRowState
Atributos

Campos

Added Added Added Added 4

Una fila nueva.A new row.

CurrentRows CurrentRows CurrentRows CurrentRows 22

Filas actuales, incluidas las filas sin modificar, las nuevas y las modificadas.Current rows including unchanged, new, and modified rows. De manera predeterminada, DataViewRowState se establece en CurrentRows.By default, DataViewRowState is set to CurrentRows.

Deleted Deleted Deleted Deleted 8

Una fila eliminada.A deleted row.

ModifiedCurrent ModifiedCurrent ModifiedCurrent ModifiedCurrent 16

Versión actual de los datos originales modificados (vea ModifiedOriginal).A current version of original data that has been modified (see ModifiedOriginal).

ModifiedOriginal ModifiedOriginal ModifiedOriginal ModifiedOriginal 32

Versión original de los datos modificados.The original version of the data that was modified. (Aunque se hayan modificado los datos posteriormente, están disponibles como ModifiedCurrent).(Although the data has since been modified, it is available as ModifiedCurrent).

None None None None 0

Ninguno.None.

OriginalRows OriginalRows OriginalRows OriginalRows 42

Filas originales, incluidas las filas sin modificar y las eliminadas.Original rows including unchanged and deleted rows.

Unchanged Unchanged Unchanged Unchanged 2

Una fila sin modificar.An unchanged row.

Ejemplos

En el ejemplo siguiente DataTable se crea con una sola columna.In the following example DataTable is created with a single column. Se modifican los datos y el RowStateFilter de la DataView está establecido para mostrar conjuntos de filas diferentes, según la DataViewRowState.The data is changed, and the RowStateFilter of the DataView is set to display different row sets, depending on the DataViewRowState.

static private void DemonstrateRowState()
{
    // Create a DataTable with one column.
    DataTable dataTable = new DataTable("dataTable");
    DataColumn dataColumn = new DataColumn("dataColumn");
    dataTable.Columns.Add(dataColumn);

    // Add ten rows.
    DataRow dataRow;
    for (int i = 0; i < 10; i++)
    {
        dataRow = dataTable.NewRow();
        dataRow["dataColumn"] = "item " + i;
        dataTable.Rows.Add(dataRow);
    }
    dataTable.AcceptChanges();

    // Create a DataView with the table.
    DataView dataView = new DataView(dataTable);

    // Change one row's value:
    dataTable.Rows[1]["dataColumn"] = "Hello";

    // Add one row:
    dataRow = dataTable.NewRow();
    dataRow["dataColumn"] = "World";
    dataTable.Rows.Add(dataRow);

    // Set the RowStateFilter to display only added and modified rows.
    dataView.RowStateFilter = DataViewRowState.Added
        | DataViewRowState.ModifiedCurrent;

    // Print those rows. Output = "Hello" "World";
    PrintView(dataView, "ModifiedCurrent and Added");

    // Set filter to display on originals of modified rows.
    dataView.RowStateFilter = DataViewRowState.ModifiedOriginal;
    PrintView(dataView, "ModifiedOriginal");

    // Delete three rows.
    dataTable.Rows[1].Delete();
    dataTable.Rows[2].Delete();
    dataTable.Rows[3].Delete();

    // Set the RowStateFilter to display only Added and modified rows.
    dataView.RowStateFilter = DataViewRowState.Deleted;
    PrintView(dataView, "Deleted");

    //Set filter to display only current.
    dataView.RowStateFilter = DataViewRowState.CurrentRows;
    PrintView(dataView, "Current");

    // Set filter to display only unchanged rows.
    dataView.RowStateFilter = DataViewRowState.Unchanged;
    PrintView(dataView, "Unchanged");

    // Set filter to display only original rows.
    dataView.RowStateFilter = DataViewRowState.OriginalRows;
    PrintView(dataView, "OriginalRows");
}


static private void PrintView(DataView dataView, string label)
{
    Console.WriteLine("\n" + label);
    for (int i = 0; i < dataView.Count; i++)
    {
        Console.WriteLine(dataView[i]["dataColumn"]);
    }
}
Private Sub DemonstrateRowState()
    Dim i As Integer

    ' Create a DataTable with one column.
    Dim dataTable As New DataTable("dataTable")
    Dim dataColumn As New DataColumn("dataColumn")
    dataTable.Columns.Add(dataColumn)

    ' Add ten rows.
    Dim dataRow As DataRow
    For i = 0 To 9
        dataRow = dataTable.NewRow()
        dataRow("dataColumn") = "item " + i.ToString()
        dataTable.Rows.Add(dataRow)
    Next i
    dataTable.AcceptChanges()

    ' Create a DataView with the table.
    Dim dataView As New DataView(dataTable)

    ' Change one row's value:
    dataTable.Rows(1)("dataColumn") = "Hello"

    ' Add one row:
    dataRow = dataTable.NewRow()
    dataRow("dataColumn") = "World"
    dataTable.Rows.Add(dataRow)

    ' Set the RowStateFilter to display only Added and modified rows.
    dataView.RowStateFilter = _
    DataViewRowState.Added Or DataViewRowState.ModifiedCurrent

    ' Print those rows. Output = "Hello" "World";
    PrintView(dataView, "ModifiedCurrent and Added")

    ' Set filter to display on originals of modified rows.
    dataView.RowStateFilter = DataViewRowState.ModifiedOriginal
    PrintView(dataView, "ModifiedOriginal")

    ' Delete three rows.
    dataTable.Rows(1).Delete()
    dataTable.Rows(2).Delete()
    dataTable.Rows(3).Delete()

    ' Set the RowStateFilter to display only Added and modified rows.
    dataView.RowStateFilter = DataViewRowState.Deleted
    PrintView(dataView, "Deleted")

    'Set filter to display only current.
    dataView.RowStateFilter = DataViewRowState.CurrentRows
    PrintView(dataView, "Current")

    ' Set filter to display only unchanged rows.
    dataView.RowStateFilter = DataViewRowState.Unchanged
    PrintView(dataView, "Unchanged")

    ' Set filter to display only original rows.
    dataView.RowStateFilter = DataViewRowState.OriginalRows
    PrintView(dataView, "OriginalRows")
End Sub

Private Sub PrintView(ByVal dataView As DataView, ByVal label As String)
    Console.WriteLine(ControlChars.Cr + label)
    Dim i As Integer
    For i = 0 To dataView.Count - 1
        Console.WriteLine(dataView(i)("dataColumn"))
    Next i
End Sub

Comentarios

El DataViewRowState valores se utilizan para recuperar una versión determinada de datos desde un DataRow, o para determinar las versiones existentes.The DataViewRowState values are used either to retrieve a particular version of data from a DataRow, or to determine what versions exist.

Establecer el RowStateFilter propiedad de la DataView para especificar la versión o versiones de datos que desea ver.Set the RowStateFilter property of the DataView to specify which version or versions of data you want to view.

Puede usar el operador booleano Or con los valores para obtener más de una versión.You can use the Boolean operator Or with the values to get more than one version.

El DataTable usa DataViewRowState en el Select método.The DataTable uses DataViewRowState in the Select method.

Se aplica a

Consulte también: