DataRowState 列舉

定義

取得 DataRow 物件的狀態。Gets the state of a DataRow object.

此列舉有 FlagsAttribute 屬性,因此其成員值可進行位元組合。

public enum class DataRowState
[System.Flags]
public enum DataRowState
[<System.Flags>]
type DataRowState = 
Public Enum DataRowState
繼承
DataRowState
屬性

欄位

Added 4

資料列已經加入至 DataRowCollection,並且尚未呼叫 AcceptChanges()The row has been added to a DataRowCollection, and AcceptChanges() has not been called.

Deleted 8

使用 Delete()DataRow 方法來刪除資料列。The row was deleted using the Delete() method of the DataRow.

Detached 1

資料列已建立,但它不屬於任何 DataRowCollectionThe row has been created but is not part of any DataRowCollection. DataRow 在已經建立後、加入至集合前,或如果已經從集合移除後,會立即處在這個狀態中。A DataRow is in this state immediately after it has been created and before it is added to a collection, or if it has been removed from a collection.

Modified 16

已經修改資料列,並且尚未呼叫 AcceptChanges()The row has been modified and AcceptChanges() has not been called.

Unchanged 2

資料列從上次呼叫 AcceptChanges() 之後就未變更。The row has not changed since AcceptChanges() was last called.

範例

下列範例會先建立一個具有一個資料行的新資料 DataTable 行,然後建立一個新的 DataRowThe following example first creates a new DataTable with one column, then creates a single DataRow. DataRow 建立、新增、修改和刪除時, RowState 會列印其。As the DataRow is created, added, modified, and deleted, its RowState is printed.

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;
}
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

備註

DataRowState列舉是由 RowState 類別的屬性傳回 DataRowThe DataRowState enumeration is returned by the RowState property of the DataRow class.

適用於

另請參閱