Les valeurs DataRowVersion sont utilisées lors de la récupération de la valeur trouvée dans DataRow à l'aide de Item ou du GetChildRows de l'objet DataRow.

DataRowVersion vous informe de la version de DataRow qui existe. Les versions sont modifiées dans les circonstances suivantes :

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

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

• Après l'appel à la méthode EndEdit de l'objet DataRow, la valeur Proposed devient la valeur Current.

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

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

• Après l'appel au RejectChanges de l'objet DataRow, la valeur Proposed est ignorée et la version devient Current.

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

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

.NET Compact Framework