DataRowVersion Enumeration

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Beschreibt die Version einer DataRow.

public enum class DataRowVersion
public enum DataRowVersion
type DataRowVersion = 
Public Enum DataRowVersion
Vererbung
Object
ValueType
Enum
DataRowVersion

Felder

Current 512

Die Zeile enthält aktuelle Werte.
Default 1536

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.
Original 256

Die Zeile enthält die ursprünglichen Werte.
Proposed 1024

Die Zeile enthält einen vorgeschlagenen Wert.

Beispiele

Im folgenden Beispiel wird die DataRowVersion Methode DataRow vor dem Aufrufen der AcceptChanges Methode überprüft.

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

Hinweise

Die DataRowVersion Werte werden beim Abrufen des Werts verwendet, der in einer DataRow Verwendung Item[] oder dem GetChildRows Objekt DataRow gefunden wurde.

Dies DataRowVersion informiert Sie darüber, welche Version einer DataRow vorhandenen Version vorhanden ist. Versionen ändern sich unter den folgenden Umständen:

  • Nachdem Sie die Methode des DataRow Objekts BeginEdit aufgerufen haben, werden die Current Proposed Werte verfügbar, wenn Sie den Wert ändern.

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

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

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

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

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

Gilt für

Siehe auch