DataRowVersion Énumération

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Décrit la version d’une DataRow.

public enum class DataRowVersion

public enum DataRowVersion

type DataRowVersion = 

Public Enum DataRowVersion

Héritage

Object

ValueType

Enum

DataRowVersion

Champs

Current	512	La ligne contient les valeurs actuelles.
Default	1536	La version par défaut de DataRowState. Pour une valeur DataRowState de Added, Modified ou Deleted, la version par défaut est Current. Pour une valeur DataRowState de Detached, la version est Proposed.
Original	256	La ligne contient ses valeurs d’origine.
Proposed	1024	La ligne contient une valeur proposée.

Exemples

L’exemple suivant vérifie le DataRowVersion d’un DataRow avant d’appeler la AcceptChanges méthode .

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 dans un DataRow using Item[] ou de GetChildRows l’objet DataRow .

vous DataRowVersion indique quelle version d’un DataRow existe. Les versions changent dans les circonstances suivantes :

• Après avoir appelé la DataRow méthode de l’objet BeginEdit , si vous modifiez la valeur, les Current valeurs et Proposed deviennent disponibles.

• Après avoir appelé la DataRow méthode de l’objet CancelEdit , la Proposed valeur est supprimée.

• Après avoir appelé la DataRow méthode de l’objet EndEdit , la valeur Proposée devient la Current valeur .

• Après avoir appelé la DataRow méthode de l’objet AcceptChanges , la Original valeur devient identique à la Current valeur .

• Après avoir appelé la DataTable méthode de l’objet AcceptChanges , la Original valeur devient identique à la Current valeur .

• Après avoir appelé la DataRow méthode de l’objet RejectChanges , la Proposed valeur est ignorée et la version devient Current.

Voir aussi

• AcceptChanges()
• BeginEdit()
• EndEdit()
• Item[Int32]
• RejectChanges()