Ler em inglês

Compartilhar via


DataRowVersion Enumeração

Definição

Descreve a versão de um DataRow.

C#
public enum DataRowVersion
Herança
DataRowVersion

Campos

Nome Valor Description
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 .

C#
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;
}

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

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Confira também