DataRowState-Enumeration

Ruft den Zustand eines DataRow-Objekts ab.

Diese Enumeration verfügt über ein FlagsAttribute -Attribut, das die bitweise Kombination der Memberwerte zulässt.

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

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration DataRowState
'Usage
Dim instance As DataRowState

[FlagsAttribute] 
public enum DataRowState

[FlagsAttribute] 
public enum class DataRowState

/** @attribute FlagsAttribute() */ 
public enum DataRowState

FlagsAttribute 
public enum DataRowState

Member

	Membername	Beschreibung
	Added	Die Zeile wurde einer DataRowCollection-Klasse hinzugefügt, und AcceptChanges wurde nicht aufgerufen.
	Deleted	Die Zeile wurde mit der Delete-Methode von DataRow gelöscht.
	Detached	Die Zeile wurde erstellt, ist jedoch nicht Teil einer DataRowCollection-Klasse. Eine DataRow-Klasse befindet sich in diesem Zustand, wenn sie unmittelbar nach ihrer Erstellung noch keiner Auflistung hinzugefügt wurde oder wenn sie aus einer Auflistung entfernt wurde.
	Modified	Die Zeile wurde geändert, und AcceptChanges wurde nicht aufgerufen.
	Unchanged	Die Zeile wurde nach dem letzten Aufruf von AcceptChanges nicht geändert.

Hinweise

Die DataRowState-Enumeration wird von der RowState-Eigenschaft der DataRow-Klasse zurückgegeben.

Beispiel

Im folgenden Beispiel wird zunächst eine neue DataTable-Klasse mit einer Spalte erstellt. Anschließend wird eine einzelne DataRow-Klasse erstellt. Beim Erstellen, Hinzufügen, Ändern und Löschen der DataRow-Klasse wird ihre RowState-Eigenschaft ausgegeben.

Private Sub DemonstrateRowState()
    'Run a function to create a DataTable with one column.
    Dim dataTable As DataTable = MakeTable()
    Dim dataRow As DataRow

    ' Create a new DataRow.
    dataRow = dataTable.NewRow()
    ' Detached row.
    Console.WriteLine(String.Format("New Row {0}", dataRow.RowState))

    dataTable.Rows.Add(dataRow)
    ' New row.
    Console.WriteLine(String.Format("AddRow {0}", dataRow.RowState))

    dataTable.AcceptChanges()
    ' Unchanged row.
    Console.WriteLine(String.Format("AcceptChanges {0}", dataRow.RowState))

    dataRow("FirstName") = "Scott"
    ' Modified row.
    Console.WriteLine(String.Format("Modified {0}", dataRow.RowState))

    dataRow.Delete()
    ' Deleted row.
    Console.WriteLine(String.Format("Deleted {0}", dataRow.RowState))
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

private void DemonstrateRowState() {
   //Run a function to create a DataTable with one column.
   DataTable myTable = MakeTable();
   DataRow myRow;

   // Create a new DataRow.
   myRow = myTable.NewRow();
   // Detached row.
   Console.WriteLine("New Row " + myRow.RowState);

   myTable.Rows.Add(myRow);
   // New row.
   Console.WriteLine("AddRow " + myRow.RowState);

   myTable.AcceptChanges();
   // Unchanged row.
   Console.WriteLine("AcceptChanges " + myRow.RowState);

   myRow["FirstName"] = "Scott";
   // Modified row.
   Console.WriteLine("Modified " + myRow.RowState);

   myRow.Delete();
   // Deleted row.
   Console.WriteLine("Deleted " + myRow.RowState);
}

private DataTable MakeTable(){
   // Make a simple table with one column.
   DataTable dt = new DataTable("myTable");
   DataColumn dcFirstName = new DataColumn("FirstName", Type.GetType("System.String"));
   dt.Columns.Add(dcFirstName);
   return dt;
}

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
DataRow-Klasse
Delete
NewRow
DataRowCollection-Klasse