DataRowVersion Enumeration

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 der DataRowVersion eines DataRow überprüft, bevor die AcceptChanges -Methode aufgerufen wird.

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 using Item[] oder der GetChildRows des DataRow -Objekts gefunden wurde.

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

Wenn Sie nach dem Aufrufen der DataRow -Methode des BeginEdit Objekts den Wert ändern, werden die Current Werte und Proposed verfügbar.
Nach dem Aufrufen der DataRow -Methode des CancelEdit Objekts wird der Proposed Wert gelöscht.
Nach dem Aufrufen der DataRow -Methode des EndEdit Objekts wird der Vorgeschlagene Wert zum Current Wert.
Nach dem Aufrufen der DataRow -Methode des AcceptChanges Objekts wird der Original Wert mit dem Current -Wert identisch.
Nach dem Aufrufen der DataTable -Methode des AcceptChanges Objekts wird der Original Wert mit dem Current -Wert identisch.
Nach dem Aufrufen der DataRow -Methode des RejectChanges Objekts wird der Proposed Wert verworfen, und die Version wird Currentzu .

Gilt für:

Freigeben über