BeforeRowUpdate イベント

行が更新される前、つまり、その行のセルに対して加えられた変更が、データソースに対して実際にコミットされる前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event BeforeRowUpdate As CancelableRowEventHandler

C#

public event CancelableRowEventHandler BeforeRowUpdate

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、CancelableRowEventArgs 型の引数を受け取りました。次の CancelableRowEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
Row	セルが属する行を返します。

解説

row引数は、更新される行でプロパティを設定でき、メソッドを呼び出すUltraGridRowオブジェクトへの参照を返します。この参照を使用して、返された行のプロパティを設定したり、メソッドを呼び出したりすることができます。

cancel 引数を使用してプログラムで、ユーザーが行が更新したりデータソースに変更をコミットすることを防止できます。一定の条件が満たされない限り、ユーザーが行を更新できないようにすることが可能です。

行が更新された後、つまり、その行のセルに対して加えられた変更が、データソースに対して実際にコミットされた時にこのイベントが生成されます。更新が発生するときに、データソースが採用するレコードのロックのタイプや UpdateMode プロパティの値などのさまざまな要素が影響する可能性があるため、行がフォーカスを失った時にこれは必要ではありません。BeforeCellUpdate イベントは、セルが新しい値を受け取ると生成されます。

ユーザーがセルに変更を行うことを防止するには、AllowUpdate プロパティを 2 (AllowUpdateNo) に設定します。Value プロパティを設定することでセルの値をプログラムで変更できます。

Update メソッドを起動することで行をプログラムで更新できます。

提供された cancel を True に設定しなければ、このイベントの後に AfterRowUpdate イベント (行が更新されたに発生するイベント) が発生します。

使用例

Visual Basic

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

   Private Sub UltraGrid1_BeforeRowUpdate(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.CancelableRowEventArgs) Handles ultraGrid1.BeforeRowUpdate

       ' Setting the Cancel to true will cause the grid to cancel the update. More precisely, it
       ' will call CancelUpdate on row objects.

       Debug.WriteLine("Canceling the row update on row with list index of " & e.Row.ListIndex)

       e.Cancel = True

   End Sub

C#

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

private void ultraGrid1_BeforeRowUpdate(object sender, Infragistics.Win.UltraWinGrid.CancelableRowEventArgs e)
{

	// Setting the Cancel to true will cause the grid to cancel the update. More precisely, it
	// will call CancelUpdate on row objects.

	Debug.WriteLine( "Canceling the row update on row with list index of " + e.Row.ListIndex );

	e.Cancel = true;

}