'宣言 Public Event CellDataUpdating As CellDataUpdatingEventHandler
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 に設定してデータがキャッシュされないようにします。
注意: このイベントは、値をコードで設定した場合は発生しません。
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
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( ) ); }