DataChanged プロパティ (UltraGridCell)

セルまたは行のデータが変更されたもののデータソースにまだコミットされていないかどうかを決める値を返します。このプロパティは実行時には読み取り専用です。このプロパティは設計時には使用できません。

シンタックス

Visual Basic

'宣言
 
Public ReadOnly Property DataChanged As Boolean

C#

public bool DataChanged {get;}

解説

このプロパティは、セルまたは行のデータが変更されているが、まだこれらの変更がデータソースにコミットされていない場合に True を返します。そうでなければ False を返します。

セルの値が変更されると、プログラムでその Value プロパティまたはユーザー操作で設定します。このプロパティは True に設定され、BeforeCellUpdate および AfterCellUpdate イベントが生成されます。ただし、実際に更新が発生するときに、データソースが採用するレコードのロックのタイプや UpdateMode プロパティの値などのさまざまな要素が影響する可能性があるため、セルの新しい値がこの時点でデータソースにコミットされている必要はありません。データソースが実際に更新されると、BeforeRowUpdate および AfterRowUpdate イベントが生成され、このプロパティの値は False に戻ります。

セルの OriginalValue プロパティは、変更前にセルの値を決定するために使用できます。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid
Imports System.Diagnostics

   Private Sub Button107_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button107.Click

       Dim row As UltraGridRow = Me.UltraGrid1.Rows(0)
       Dim cell As UltraGridCell = row.Cells("Phone")

       ' Write ou the cell's and the row's DataChanged property values.
       Debug.WriteLine("Before setting the cell's Value, cell.DataChanged = " & cell.DataChanged)
       Debug.WriteLine("Before setting the cell's Value, row.DataChanged = " & row.DataChanged)

       cell.Value = "123456789"

       ' DataChanged properties should return true given the cell's previous value was something
       ' other than "123456789".
       Debug.WriteLine("After setting the cell's Value, cell.DataChanged = " & cell.DataChanged)
       Debug.WriteLine("After setting the cell's Value, row.DataChanged = " & row.DataChanged)

   End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button107_Click(object sender, System.EventArgs e)
{

	UltraGridRow row = this.ultraGrid1.Rows[0];
	UltraGridCell cell = row.Cells["Phone"];

	// Write ou the cell's and the row's DataChanged property values.
	Debug.WriteLine( "Before setting the cell's Value, cell.DataChanged = " + cell.DataChanged );
	Debug.WriteLine( "Before setting the cell's Value, row.DataChanged = " + row.DataChanged );

	cell.Value = "123456789";

	// DataChanged properties should return true given the cell's previous value was something
	// other than "123456789".
	Debug.WriteLine( "After setting the cell's Value, cell.DataChanged = " + cell.DataChanged );
	Debug.WriteLine( "After setting the cell's Value, row.DataChanged = " + row.DataChanged );

}