CellDataUpdating イベント

このUltraDataSourceにバインドされたコントロールがセル値を更新する前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event CellDataUpdating As CellDataUpdatingEventHandler

C#

public event CellDataUpdatingEventHandler CellDataUpdating

イベント データ

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

プロパティ	解説
CacheData	データをキャッシュするかどうかを指定します。デフォルト値は true です。UltraDataSourceにデータを保持しない場合はFalseに設定します。この場合、列にキャッシュされている既存のデータがあればクリアされます。次回同じセルでデータが必要になったときには CellDataRequested イベントが発生します。
Cancel System.ComponentModel.CancelEventArgsから継承されます。
Column	列を取得します。
NewValue	セルの新しい値。このプロパティには異なる値を設定できます。
Row	行を取得します。

解説

CellDataUpdating は、この UltraDataSource にバインドされたコントロールがセル値を更新する前に発生します。元の値を維持する場合は、CellDataUpdatingEventArgs の Cancel を True に設定して更新をキャンセルします。また、CellDataUpdatingEventArgs.NewValue を異なる値に設定して更新値を変更することもできます。

デフォルトでは、UltraDataSource はセルの新しい値をキャッシュします。開発者側でデータを管理する場合は、CellDataUpdatingEventArgs.CacheData を False に設定してデータがキャッシュされないようにします。

注意: このイベントは、値をコードで設定した場合は発生しません。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinDataSource
Imports Infragistics.Win.UltraWinGrid


    Private Sub UltraDataSource1_CellDataUpdating(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinDataSource.CellDataUpdatingEventArgs) Handles UltraDataSource1.CellDataUpdating
        ' CellDataUpdating is fired when a field is modified in a control bound
        ' to this data source. Typically you update the external data source with
        ' the new value if there is an external data source.

        Debug.WriteLine( _
         e.Column.Key & " field " & " in row " & e.Row.Index _
         & " is being updated to new value of " & e.NewValue.ToString())

        ' If there is an external data source that's being used to provide the
        ' data to the ultradata source and that external data source is updated
        ' with the new value, you would set the CacheData to false since you 
        ' don't want the UltraDataSource to keep the value.
        e.CacheData = False

        ' You can also set the Cancel to true to prevent the UltraDataSource 
        ' from updating with the new value.
        e.Cancel = True
    End Sub

    Private Sub UltraDataSource1_CellDataUpdated(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinDataSource.CellDataUpdatedEventArgs) Handles UltraDataSource1.CellDataUpdated
        ' CellDataUpdated is fired after CellDataUpdating is fired.

        Debug.WriteLine( _
         e.Column.Key & " field " & " in row " & e.Row.Index _
         & " is updated to new value of " & e.NewValue.ToString())
    End Sub

C#

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


		private void ultraDataSource1_CellDataUpdating(object sender, Infragistics.Win.UltraWinDataSource.CellDataUpdatingEventArgs e)
		{
			// CellDataUpdating is fired when a field is modified in a control bound
			// to this data source. Typically you update the external data source with
			// the new value if there is an external data source.
			
			Debug.WriteLine(
				e.Column.Key + " field " + " in row " + e.Row.Index 
				+ " is being updated to new value of " + e.NewValue.ToString( ) );

			// If there is an external data source that's being used to provide the
			// data to the ultradata source and that external data source is updated
			// with the new value, you would set the CacheData to false since you 
			// don't want the UltraDataSource to keep the value.
			e.CacheData = false;

			// You can also set the Cancel to true to prevent the UltraDataSource 
			// from updating with the new value.
			e.Cancel = true;
		}

		private void ultraDataSource1_CellDataUpdated(object sender, Infragistics.Win.UltraWinDataSource.CellDataUpdatedEventArgs e)
		{
			// CellDataUpdated is fired after CellDataUpdating is fired.

			Debug.WriteLine(
				e.Column.Key + " field " + " in row " + e.Row.Index 
				+ " is updated to new value of " + e.NewValue.ToString( ) );
		}