DataRowVersion 列挙体

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

DataRowVersion 列挙体

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

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

Visual Basic (宣言)

Public Enumeration DataRowVersion

Visual Basic (使用法)

Dim instance As DataRowVersion

C#

public enum DataRowVersion

C++

public enum class DataRowVersion

J#

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

プラットフォーム

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

参照

関連項目
System.Data 名前空間
AcceptChanges
BeginEdit
EndEdit
Item
RejectChanges