Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Enumeração DataRowVersion

 

Publicado: agosto de 2016

System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Descreve a versão de um DataRow.

Namespace:   System.Data
Assembly:  System.Data (em System.Data.dll)

public enum DataRowVersion

Nome do membroDescrição
Current

A linha contém os valores atuais.

Default

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

A linha contém os valores originais.

Proposed

A linha contém um valor proposto.

O DataRowVersion valores são usados durante a recuperação do valor encontrado em uma DataRow usando Item ou GetChildRows do DataRow objeto.

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

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

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

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

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

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

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

A exemplo a seguir verifica o DataRowVersion de um DataRow antes de chamar 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;
}

.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: