Compartilhar via


DataRowVersion Enumeração

Definição

Descreve a versão de um DataRow.

public enum class DataRowVersion
public enum DataRowVersion
type DataRowVersion = 
Public Enum DataRowVersion
Herança
DataRowVersion

Campos

Current 512

A linha contém os valores atuais.

Default 1536

A versão padrão do DataRowState. Para um valor DataRowState igual a Added, Modified ou Deleted, a versão padrão é Current. Para um valor DataRowState igual a Detached, a versão é Proposed.

Original 256

A linha contém os valores originais.

Proposed 1024

A linha contém um valor proposto.

Exemplos

O exemplo a seguir verifica o DataRowVersion de um DataRow antes de invocar o 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

Comentários

Os DataRowVersion valores são usados ao recuperar o valor encontrado em um DataRow uso Item[] ou no GetChildRows do DataRow objeto .

O DataRowVersion informa qual versão de um DataRow existe. As versões são alteradas nas seguintes circunstâncias:

  • Depois de chamar o DataRow método do BeginEdit objeto, se você alterar o valor, os Current valores e Proposed ficarão disponíveis.

  • Depois de chamar o DataRow método do CancelEdit objeto, o Proposed valor é excluído.

  • Depois de chamar o DataRow método do EndEdit objeto, o valor Proposto se torna o Current valor .

  • Depois de chamar o DataRow método do AcceptChanges objeto, o Original valor se torna idêntico ao Current valor .

  • Depois de chamar o DataTable método do AcceptChanges objeto, o Original valor se torna idêntico ao Current valor .

  • Depois de chamar o DataRow método do RejectChanges objeto, o Proposed valor é descartado e a versão se torna Current.

Aplica-se a

Confira também