Datasnap.Provider.TCustomResolver.ApplyUpdates

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

Delphi

function ApplyUpdates(const Delta: OleVariant; MaxErrors: Integer;
out ErrorCount: Integer): OleVariant; virtual;

C++

virtual System::OleVariant __fastcall ApplyUpdates(const System::OleVariant &Delta, int MaxErrors, /* out */ int &ErrorCount);

プロパティ

種類 可視性 ソース ユニット
function public
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider TCustomResolver

説明

プロバイダから受け取った更新を適用します。

プロバイダは,ApplyUpdates メソッドを呼び出して,クライアントデータセットまたは XML ブローカから受け取った更新を適用します。

ApplyUpdates は,関連付けられているプロバイダで OnUpdateData イベントを生成し,Delta パラメータで渡された更新を適用し,適用できなかった更新を格納する OleVariant を返します。

Delta パラメータは,適用する挿入,削除,および変更を含むデルタパケットを指定します。MaxErrors は,更新処理を中止するまでに許可するエラーの最大数を示します。ErrorCount パラメータは,更新処理中に実際に発生したエラーの数を返します。ErrorCount が MaxErrors より大きい場合(OnUpdateError イベントが rrAbort を返す場合),それまでに適用されたすべての更新がロールバックされ,更新プロセスが中止されます。

関連付けられているプロバイダに OnUpdateError イベントハンドラがある場合は,Delta のレコードが更新できないときにそのイベントハンドラが自動的に呼び出されます。OnUpdateError イベントハンドラでは,アプリケーションはエラー状態を修正し,更新できなかったレコードをクライアントデータセットまたは XML ブローカに返す前に更新の適用を再び試みることができます。

関連項目