DataRow.RowState-Eigenschaft

Ruft den aktuellen Zustand der Zeile bezüglich ihrer Beziehung zur DataRowCollection ab.

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

Syntax

'Declaration
Public ReadOnly Property RowState As DataRowState
'Usage
Dim instance As DataRow
Dim value As DataRowState

value = instance.RowState

public DataRowState RowState { get; }

public:
property DataRowState RowState {
    DataRowState get ();
}

/** @property */
public DataRowState get_RowState ()

public function get RowState () : DataRowState

Eigenschaftenwert

Einer der DataRowState-Werte.

Hinweise

Der Wert von RowState hängt von zwei Faktoren ab: (1) der Art der Operation, die an der Zeile ausgeführt wurde, und (2) ob AcceptChanges für die DataRow aufgerufen wurde.

Beispiel

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

Private Sub DemonstrateRowState()
    ' Run a function to create a DataTable with one column.
    Dim table As DataTable = MakeTable()
    Dim row As DataRow 
 
    ' Create a new DataRow.
    row = table.NewRow()
    ' Detached row.
    Console.WriteLine("New Row " & row.RowState)
 
    table.Rows.Add(row)
    ' New row.
    Console.WriteLine("AddRow " & row.RowState)
 
    table.AcceptChanges()
    ' Unchanged row.
    Console.WriteLine("AcceptChanges " & row.RowState)
 
    row("FirstName") = "Scott"
    ' Modified row.
    Console.WriteLine("Modified " & row.RowState)
 
    row.Delete()
    ' Deleted row.
    Console.WriteLine("Deleted " & row.RowState)
 End Sub
 
 Private Function MakeTable() As DataTable
    ' Make a simple table with one column.
    Dim table As DataTable = New DataTable("table")
    Dim dcFirstName As DataColumn = New DataColumn( _
        "FirstName", Type.GetType("System.String"))
    table.Columns.Add(dcFirstName)
    MakeTable = table
 End Function

private void DemonstrateRowState()
{
    // Run a function to create a DataTable with one column.
    DataTable table = MakeTable();
    DataRow row;
 
    // Create a new DataRow.
    row = table.NewRow();
    // Detached row.
    Console.WriteLine("New Row " + row.RowState);
 
    table.Rows.Add(row);
    // New row.
    Console.WriteLine("AddRow " + row.RowState);
 
    table.AcceptChanges();
    // Unchanged row.
    Console.WriteLine("AcceptChanges " + row.RowState);
 
    row["FirstName"] = "Scott";
    // Modified row.
    Console.WriteLine("Modified " + row.RowState);
 
    row.Delete();
    // Deleted row.
    Console.WriteLine("Deleted " + row.RowState);
}
 
private DataTable MakeTable()
{
    // Make a simple table with one column.
    DataTable table = new DataTable("table");
    DataColumn dcFirstName = new DataColumn(
        "FirstName", Type.GetType("System.String"));
    table.Columns.Add(dcFirstName);
    return table;
}

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

DataRow-Klasse
DataRow-Member
System.Data-Namespace
AcceptChanges
BeginEdit
Add
CancelEdit
DataTable
DataRowView
Delete
EndEdit
NewRow