API:FireDAC.Comp.Client.TFDRdbmsDataSet.OnError
Delphi
property OnError: TFDErrorEvent read GetOnError write SetOnError;
C++
__property Firedac::Stan::Error::TFDErrorEvent OnError = {read=GetOnError, write=SetOnError};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| event | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDRdbmsDataSet |
説明
データセットが DBMS とやり取りしている際、エラーが生成されると、イベントが発生します。
FireDAC.Comp.Client.TFDRdbmsDataSet.OnError は FireDAC.Comp.Client.TFDAdaptedDataSet.OnError を継承しています。以下の内容はすべて FireDAC.Comp.Client.TFDAdaptedDataSet.OnError を参照しています。
データセットが DBMS とやり取りしている際、エラーが生成されると、イベントが発生します。
OnError イベントは、データセットが次のいずれかのデータセットのオペレーションを実行し、エラーが生成された際に、発生します。
- Prepare。 データセットは、実行のための DBMS コマンドを準備します。
- Open。データセットは、カーソルを開く DBMS コマンドを実行します。
- ExecSQL/ExecProc/Execute。データセットは、DBMS コマンドを実行します。
Fetch。データセットは、カーソルから行をフェッチします。
OnError のイベント ハンドラは、次のパラメータを受け取ります：
ASenderは、適用したデータセットです。AInitiatorは、例外を発生させるオブジェクトです。AExceptionは例外です。これは、通常 EFDDBEngineException のインスタンスです。
OnError を処理して、例外オブジェクトを分析および修正することができます。新たに例外オブジェクトを作成して、それを AException に割り当てることも可能です。それを行った場合、元の例外オブジェクトを解放しなければなりません。
また、OnExecuteError イベントを使用して、配列 DML エラーの処理を、OnUpdateError イベントを使用して、送信エラーの更新を処理することができます。