Bde.DBTables.TBDEDataSet.OnUpdateError

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

property OnUpdateError: TUpdateErrorEvent read FOnUpdateError write SetOnUpdateError;

C++

__property Data::Db::TUpdateErrorEvent OnUpdateError = {read=FOnUpdateError, write=SetOnUpdateError};

プロパティ

種類 可視性 ソース ユニット
event published
Bde.DBTables.pas
Bde.DBTables.hpp
Bde.DBTables TBDEDataSet


説明

キャッシュされた更新をデータベースに適用する際、例外が生成された場合に発生します。

OnUpdateError イベント ハンドラを記述すると、キャッシュされた更新をデータベースに適用する際に生成された例外に、応答することができます。

あるレコードが最初にキャッシュされた時から、キャッシュされた更新が適用されるまでには時差があるため、そのキャッシュされた変更が適用される前に、別のアプリケーションがデータベース内の同じレコードを変更している可能性があります。Borland Database Engine (BDE) は、この状態をチェックして、例外を発生させてくれます。TBDEDataSet は、OnUpdateError イベント ハンドラがあれば、それを呼び出して対応します。

メモ: ApplyUpdates への呼び出しで例外が生じ、かつ、ApplyUpdates が例外ブロックのコンテキスト内で呼び出されていない場合、エラー メッセージが表示されます。OnUpdateError ハンドラがエラー状態を訂正できず、UpdateAction が uaFail に設定されているままだった場合、このエラー メッセージは 2 回表示されます。重複表示を避けるためには、エラー ハンドラ内で UpdateAction を uaAbort に設定します。

警告: OnUpdateError ハンドラ内のコードでは、異なるレコードをカレント レコードにしてしまうようなメソッドは呼び出してはいけません。

OnUpdateError は、Data.DB.TUpdateErrorEvent 型のイベント ハンドラです。

関連項目