DataRowVersion Enumeration

Definition

Beschreibt die Version einer DataRow.Describes the version of a DataRow.

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

Felder

Current 512

Die Zeile enthält aktuelle Werte.The row contains current values.

Default 1536

Die Standardversion von DataRowState.The default version of DataRowState. Für einen DataRowState-Wert von Added, Modified oder Deleted ist die Standardversion Current.For a DataRowState value of Added, Modified or Deleted, the default version is Current. Für einen DataRowState-Wert von Detached ist die Version Proposed.For a DataRowState value of Detached, the version is Proposed.

Original 256

Die Zeile enthält die ursprünglichen Werte.The row contains its original values.

Proposed 1024

Die Zeile enthält einen vorgeschlagenen Wert.The row contains a proposed value.

Beispiele

Im folgenden Beispiel wird der DataRowVersion DataRow eines überprüft, bevor die AcceptChanges -Methode aufgerufen wird.The following example checks the DataRowVersion of a DataRow before invoking the AcceptChanges method.

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 verwendet, wenn der Wert, der in DataRow einem Item[String, DataRowVersion] DataRow verwendet wird GetChildRows , oder der des-Objekts abgerufen wird.The DataRowVersion values are used when retrieving the value found in a DataRow using Item[String, DataRowVersion] or the GetChildRows of the DataRow object.

Der DataRowVersion informiert Sie darüber, welche Version DataRow von vorhanden ist.The DataRowVersion informs you what version of a DataRow exists. In den folgenden Situationen ändern sich Versionen:Versions change under the following circumstances:

  • Nachdem Sie die DataRow -Methode BeginEdit des-Objekts aufgerufen haben, werden die Current -und Proposed -Werte verfügbar, wenn Sie den Wert ändern.After calling the DataRow object's BeginEdit method, if you change the value, the Current and Proposed values become available.

  • Nachdem die- DataRow Methode des CancelEdit -Objekts aufgerufen Proposed wurde, wird der-Wert gelöscht.After calling the DataRow object's CancelEdit method, the Proposed value is deleted.

  • Nachdem die- DataRow Methode des EndEdit -Objekts aufgerufen wurde, wird Current der vorgeschlagene Wert zum Wert.After calling the DataRow object's EndEdit method, the Proposed value becomes the Current value.

  • Nach dem Aufrufen DataRow der- AcceptChanges Methode des- Original Objekts wird der-Wert Current mit dem-Wert identisch.After calling the DataRow object's AcceptChanges method, the Original value becomes identical to the Current value.

  • Nach dem Aufrufen DataTable der- AcceptChanges Methode des- Original Objekts wird der-Wert Current mit dem-Wert identisch.After calling the DataTable object's AcceptChanges method, the Original value becomes identical to the Current value.

  • Nach dem Aufrufen DataRow der- RejectChanges Methode des- Proposed Objekts wird der Wert verworfen, und die CurrentVersion wird zu.After calling the DataRow object's RejectChanges method, the Proposed value is discarded, and the version becomes Current.

Gilt für:

Siehe auch