DataRowVersion Énumération

Définition

Décrit la version d’une DataRow.Describes the version of a DataRow.

public enum class DataRowVersion
public enum DataRowVersion
type DataRowVersion = 
Public Enum DataRowVersion
Héritage
DataRowVersion

Champs

Current 512

La ligne contient les valeurs actuelles.The row contains current values.

Default 1536

La version par défaut de DataRowState.The default version of DataRowState. Pour une valeur DataRowState de Added, Modified ou Deleted, la version par défaut est Current.For a DataRowState value of Added, Modified or Deleted, the default version is Current. Pour une valeur DataRowState de Detached, la version est Proposed.For a DataRowState value of Detached, the version is Proposed.

Original 256

La ligne contient ses valeurs d’origine.The row contains its original values.

Proposed 1024

La ligne contient une valeur proposée.The row contains a proposed value.

Exemples

L’exemple suivant vérifie le DataRowVersion d’un DataRow avant d’appeler la AcceptChanges méthode.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

Remarques

Les DataRowVersion valeurs sont utilisées lors de la récupération de la valeur trouvée DataRow dans Item[String, DataRowVersion] un DataRow objet GetChildRows à l’aide de ou de l’objet.The DataRowVersion values are used when retrieving the value found in a DataRow using Item[String, DataRowVersion] or the GetChildRows of the DataRow object.

Le DataRowVersion vous informe de la version d’un DataRow existant.The DataRowVersion informs you what version of a DataRow exists. Les versions changent dans les circonstances suivantes:Versions change under the following circumstances:

  • Après avoir appelé DataRow la méthode BeginEdit de l’objet, si vous modifiez la valeur Current , Proposed les valeurs et deviennent disponibles.After calling the DataRow object's BeginEdit method, if you change the value, the Current and Proposed values become available.

  • Après avoir appelé DataRow la méthode CancelEdit de l’objet Proposed , la valeur est supprimée.After calling the DataRow object's CancelEdit method, the Proposed value is deleted.

  • Après l’appel DataRow de la EndEdit méthode de l’objet, la valeur Current proposée devient la valeur.After calling the DataRow object's EndEdit method, the Proposed value becomes the Current value.

  • Après l’appel DataRow de la AcceptChanges méthode de l' Original objet, la valeur devient Current identique à la valeur.After calling the DataRow object's AcceptChanges method, the Original value becomes identical to the Current value.

  • Après l’appel DataTable de la AcceptChanges méthode de l' Original objet, la valeur devient Current identique à la valeur.After calling the DataTable object's AcceptChanges method, the Original value becomes identical to the Current value.

  • Après avoir appelé DataRow la méthode RejectChanges de l’objet Proposed , la valeur est ignorée et la version devient Current.After calling the DataRow object's RejectChanges method, the Proposed value is discarded, and the version becomes Current.

S’applique à

Voir aussi