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

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

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

DataRowVersion 列挙体

DataRow のバージョンを示します。

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

Visual Basic (宣言)

Public Enumeration DataRowVersion

Visual Basic (使用法)

Dim instance As DataRowVersion

public enum DataRowVersion

C++

public enum class DataRowVersion

public enum DataRowVersion

JScript

public enum DataRowVersion

メンバ

	メンバ名	説明
	Current	この行には現在の値が格納されています。
	Default	DataRowState の既定バージョン。DataRowState の値が Added、Modified、または Deleted の場合、既定バージョンは Current です。DataRowState の値が Detached の場合、既定バージョンは Proposed です。
	Original	この行には元の値が格納されています。
	Proposed	この行には提示された値が格納されています。

解説

Item、または DataRow オブジェクトの GetChildRows を使用して DataRow にある値を検索するときに、DataRowVersion 値が使用されます。

DataRowVersion は、存在する DataRow のバージョンを示します。バージョンは次の条件で変わります。

DataRow オブジェクトの BeginEdit メソッドを呼び出した後、値を変更すると、Current 値と Proposed 値が使用できるようになります。
DataRow オブジェクトの CancelEdit メソッドを呼び出すと、Proposed 値が削除されます。
DataRow オブジェクトの EndEdit メソッドを呼び出すと、Proposed 値が Current 値になります。
DataRow オブジェクトの AcceptChanges メソッドを呼び出すと、Original 値が Current 値と同じになります。
DataTable オブジェクトの AcceptChanges メソッドを呼び出すと、Original 値が Current 値と同じになります。
DataRow オブジェクトの RejectChanges を呼び出すと、Proposed 値が破棄され、そのバージョンが Current になります。

使用例

AcceptChanges メソッドを呼び出す前に DataRow の DataRowVersion を確認する例を次に示します。

Visual Basic

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

    Dim dataRow As DataRow = dataTable.NewRow()
    dataRow("FirstName") = "Marcy"
    dataTable.Rows.Add(dataRow)

    dataRow.BeginEdit()
    ' Edit data but keep the same value.
    dataRow(0) = "Marcy"
    ' Uncomment the following line to add a new value.
    ' dataRow(0) = "Richard"
    Console.WriteLine(String.Format("FirstName
 {0}", dataRow(0)))

    ' Compare the proposed version with the current.
    If dataRow.HasVersion(DataRowVersion.Proposed) Then
        If dataRow(0, DataRowVersion.Current) Is
 dataRow(0, DataRowVersion.Proposed) Then
            Console.WriteLine("The original and the proposed are
 the same.")
            dataRow.CancelEdit()
        Else
            dataRow.AcceptChanges()
            Console.WriteLine("The original and the proposed are
 different.")
        End If
    End If
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