DataRowVersion DataRowVersion DataRowVersion DataRowVersion Enum

Definición

Describe la versión de DataRow.Describes the version of a DataRow.

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

Campos

Current Current Current Current 512

La fila contiene sus valores actuales.The row contains current values.

Default Default Default Default 1536

Versión predeterminada de DataRowState.The default version of DataRowState. Para un valor de DataRowState igual a Added, Modified o Deleted, la versión predeterminada es Current.For a DataRowState value of Added, Modified or Deleted, the default version is Current. Para un valor DataRowState de Detached, la versión es Proposed.For a DataRowState value of Detached, the version is Proposed.

Original Original Original Original 256

La fila contiene sus valores originales.The row contains its original values.

Proposed Proposed Proposed Proposed 1024

La fila contiene un valor propuesto.The row contains a proposed value.

Ejemplos

En el siguiente ejemplo se DataRowVersion comprueba el DataRow de un antes de AcceptChanges invocar el método.The following example checks the DataRowVersion of a DataRow before invoking the AcceptChanges method.

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 DataRow un Item[String, DataRowVersion] DataRow mediante o GetChildRows en el del objeto.The DataRowVersion values are used when retrieving the value found in a DataRow using Item[String, DataRowVersion] or the GetChildRows of the DataRow object.

Informadequéversióndeexiste.DataRowVersion DataRowThe DataRowVersion informs you what version of a DataRow exists. Las versiones cambian en las siguientes circunstancias:Versions change under the following circumstances:

  • Después de llamar DataRow al método BeginEdit del objeto, si cambia el valor, los Current valores Proposed y estarán disponibles.After calling the DataRow object's BeginEdit method, if you change the value, the Current and Proposed values become available.

  • Después de llamar DataRow al método CancelEdit del objeto, Proposed el valor se elimina.After calling the DataRow object's CancelEdit method, the Proposed value is deleted.

  • Después de llamar DataRow al método EndEdit del objeto, el valor propuesto se Current convierte en el valor.After calling the DataRow object's EndEdit method, the Proposed value becomes the Current value.

  • Después de llamar DataRow al método AcceptChanges del objeto, Original el valor se convierte en Current idéntico al valor.After calling the DataRow object's AcceptChanges method, the Original value becomes identical to the Current value.

  • Después de llamar DataTable al método AcceptChanges del objeto, Original el valor se convierte en Current idéntico al valor.After calling the DataTable object's AcceptChanges method, the Original value becomes identical to the Current value.

  • Después de llamar DataRow al método RejectChanges del objeto, Proposed el valor se descarta y la versión se convierte en Current.After calling the DataRow object's RejectChanges method, the Proposed value is discarded, and the version becomes Current.

Se aplica a

Consulte también: