このトピックは、WebDataGrid™ における一括更新に関連したクライアント イベントおよびサーバー イベントを説明します。
クライアント側の一括更新イベント
一括更新機能を起動すると、行の変更を元に戻すときに利用できる 2 つのクライアント イベントが発生します。
batchUndone - 削除した行を復元する場合 (つまり、ユーザーが [元に戻す] ボタンをクリックしたとき) に呼び出されます。
batchUndoing - ある行に加えた変更を元に戻す場合 (つまり、ユーザーが Ctrl + Z キーを押したとき) に呼び出されます。
以下のマークアップ コードスニペットは、これらのイベントに添付する方法を示します。
ASPX の場合:
<ig:WebDataGrid ID="wdg1" runat="server">
<Behaviors>
<ig:Activation/>
<ig:EditingCore BatchUpdating="true">
<EditingClientEvents
BatchUpdateUndoing="batchUndoing"
BatchUpdateUndone="batchUndone"/>
<Behaviors>
<ig:RowAdding/>
<ig:RowDeleting/>
<ig:CellEditing/>
</Behaviors>
</ig:EditingCore>
</Behaviors>
</ig:WebDataGrid>
以下のマークアップ コードスニペットは、Javascript を使用してハンドラーを定義する方法を示します。
JavaScript の場合
function batchUndoing(sender, eventArgs) {
}
function batchUndone(sender, eventArgs) {
}
引数イベントは、元に戻している行の情報を保管します。元に戻すプロセスをキャンセルし、データに行われた変更を BatchUpdateUndoing イベント ハンドラー内に残しておくことができます。
詳細は、Batch Update Events のサンプルを参照してください。
イベントの引数の詳細は、Batch Update API を参照してください。
表 1: クライアント イベント引数の参照テーブル
サーバー側の一括更新イベント
一括更新では、一括更新が無効になっている場合と同じサーバー イベントが発生しますが、ポストバックが発生するとイベントはすべて 1 つのパスで呼び出されます。
以下のスニペットは、ハンドラーを ASPX およびコードビハインドのサーバー CRUD イベントに添付する方法を示します。
ASPX の場合:
<ig:WebDataGrid ID="wdg1" runat="server"
OnRowUpdating="wdg1_RowUpdating" OnRowUpdated="wdg1_RowUpdated"
OnRowAdding="wdg1_RowAdding" OnRowAdded="wdg1_RowAdded"
OnRowsDeleting="wdg1_RowsDeleting" OnRowDeleted="wdg1_RowDeleted">
<Behaviors>
<ig:Activation/>
<ig:Paging PageSize="7"/>
<ig:EditingCore BatchUpdating="true">
<Behaviors>
<ig:RowAdding/>
<ig:RowDeleting/>
<ig:CellEditing/>
</Behaviors>
</ig:EditingCore>
</Behaviors>
</ig:WebDataGrid>
C# の場合：
void wdg1_RowUpdating(object sender,
Infragistics.Web.UI.GridControls.RowUpdatingEventArgs e) {}
void wdg1_RowUpdated(object sender,
Infragistics.Web.UI.GridControls.RowUpdatedEventArgs e) {}
void wdg1_RowAdding(object sender,
Infragistics.Web.UI.GridControls.RowAddingEventArgs e) {}
void wdg1_RowAdded(object sender,
Infragistics.Web.UI.GridControls.RowAddedEventArgs e) {}
void wdg1_RowsDeleting(object sender,
Infragistics.Web.UI.GridControls.RowDeletingEventArgs e) {}
void wdg1_RowDeleted(object sender,
Infragistics.Web.UI.GridControls.RowDeletedEventArgs e) {}
表 2: サーバー イベント引数の参照テーブル