DataRow.RowState プロパティ

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

DataRow.RowState プロパティ

DataRowCollection とのリレーションシップに関する、行の現在の状態を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 RowState As DataRowState

Visual Basic (使用法)

Dim instance As DataRow
Dim value As DataRowState

value = instance.RowState

C#

public DataRowState RowState { get; }

C++

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

J#

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

JScript

public function get RowState
 () : DataRowState

プロパティ値
DataRowState 値の 1 つ。

解説

RowState の値は、(1) この行に対して実行された操作の種類、(2) DataRow で AcceptChanges が呼び出されたかどうか、という 2 つの要因に依存します。

使用例

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

Visual Basic

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataRow クラス
DataRow メンバ
System.Data 名前空間
AcceptChanges
BeginEdit
Add
CancelEdit
DataTable
DataRowView
Delete
EndEdit
NewRow