DataRowState 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataRowState 列挙体

DataRow オブジェクトの状態を取得します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

<FlagsAttribute> _
Public Enumeration DataRowState

Visual Basic (使用法)

Dim instance As DataRowState

[FlagsAttribute] 
public enum DataRowState

C++

[FlagsAttribute] 
public enum class DataRowState

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

JScript

FlagsAttribute 
public enum DataRowState

メンバ

	メンバ名	説明
	Added	行が DataRowCollection に追加されましたが、AcceptChanges が呼び出されていません。
	Deleted	DataRow の Delete メソッドを使用して行が削除されました。
	Detached	行が作成されましたが、どの DataRowCollection にも追加されていません。DataRow は、作成された直後からコレクションに追加されるまでの間、またはコレクションから削除された場合に、この状態になります。
	Modified	行が変更されましたが、AcceptChanges が呼び出されていません。
	Unchanged	前回 AcceptChanges が呼び出されて以降、この行は変更されていません。

解説

DataRowState 列挙体は、DataRow クラスの RowState プロパティによって返されます。

使用例

初めに 1 列の新しい DataTable を作成してから、単一の DataRow を作成する例を次に示します。DataRow の作成、追加、変更、および削除時に、その RowState が出力されます。

Visual Basic

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