Freigeben über


DataRowVersion-Enumeration

Beschreibt die Version einer DataRow-Klasse.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Enumeration DataRowVersion
'Usage
Dim instance As DataRowVersion
public enum DataRowVersion
public enum class DataRowVersion
public enum DataRowVersion
public enum DataRowVersion

Member

  Membername Beschreibung
Unterstützt von .NET Compact Framework Current Die Zeile enthält aktuelle Werte. 
Unterstützt von .NET Compact Framework Default Die Standardversion von DataRowState. Für einen DataRowState-Wert von Added, Modified oder Deleted ist die Standardversion Current. Für einen DataRowState-Wert von Detached ist die Version Proposed
Unterstützt von .NET Compact Framework Original Die Zeile enthält ihre ursprünglichen Werte. 
Unterstützt von .NET Compact Framework Proposed Die Zeile enthält einen vorgeschlagenen Wert. 

Hinweise

Die DataRowVersion-Werte werden beim Abrufen des Werts verwendet, der unter Verwendung von Item oder GetChildRows des DataRow-Objekts in einer DataRow-Klasse gefunden wurde.

DataRowVersion informiert Sie darüber, welche Version einer DataRow-Klasse vorhanden ist. Versionen werden unter den folgenden Umständen geändert:

  • Nach dem Aufrufen der BeginEdit-Methode des DataRow-Objekts werden beim Ändern des Werts der Current-Wert und der Proposed-Wert verfügbar.

  • Nach dem Aufrufen der CancelEdit-Methode des DataRow-Objekts wird der Proposed-Wert gelöscht.

  • Nach dem Aufrufen der EndEdit-Methode des DataRow-Objekts wird der Proposed-Wert zum Current-Wert.

  • Nach dem Aufrufen der AcceptChanges-Methode des DataRow-Objekts ist der Original-Wert identisch mit dem Current-Wert.

  • Nach dem Aufrufen der AcceptChanges-Methode des DataTable-Objekts ist der Original-Wert identisch mit dem Current-Wert.

  • Nach dem Aufrufen der RejectChanges-Methode des DataRow-Objekts wird der Proposed-Wert verworfen, und die Version wird Current.

Beispiel

Im folgenden Beispiel wird die DataRowVersion-Enumeration einer DataRow-Klasse überprüft, bevor die AcceptChanges-Methode aufgerufen wird.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

System.Data-Namespace
AcceptChanges
BeginEdit
EndEdit
Item
RejectChanges