Data.Win.ADODB.TCustomADODataSet.FilterGroup

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

Delphi

property FilterGroup: TFilterGroup read GetFilterGroup write SetFilterGroup;

C++

__property TFilterGroup FilterGroup = {read=GetFilterGroup, write=SetFilterGroup, nodefault};

プロパティ

種類 可視性 ソース ユニット
property public
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TCustomADODataSet

説明

行更新ステータスに基づいてレコードセットをフィルタ処理します。

FilterGroup プロパティを使用すると,ADO データセットコンポーネントで表示されるレコードセットをフィルタ処理できます。フィルタはデータセットが更新バッチモードであることを要求し,各行は各自の更新ステータスに基づいてフィルタ処理されます。FilterGroup を TFilterGroup 定数に設定すると,データセットをフィルタ処理してそのバッチ更新ステータスに一致する行だけを表示できます。たとえば FilterGroup を fgPendingRecords に設定すると,アプリケーションが最後に更新を行ってから変更された行だけを表示できます。



if (ADODataSet1.LockType = ltBatchOptimistic) then begin
ADODataSet1.Filtered := True;
ADODataSet1.FilterGroup := fgPendingRecords;
end;



if (ADODataSet1->LockType == ltBatchOptimistic)
{
ADODataSet1->Filtered = true;
ADODataSet1->FilterGroup = fgPendingRecords;
};



FilterGroup を使って行の更新ステータスに基づいてフィルタ処理を行うには,LockType プロパティを ltBatchOptimistic(バッチ更新の前提条件)に,Filtered プロパティを true に必ず設定します。フィルタ処理されたデータセットでは,RecordStatus プロパティを使って各行の更新ステータスを調べてください。

TFilterGroup 型には,以下の定数が入ります。



フィルタグループ型 意味

fgUnassigned

有効なフィルタ処理がないことを示します。この定数は,ADO データセットコンポーネントによって内部的に使用されます。

fgNone

現在のフィルタ処理を削除し,すべての行が可視になります。Filtered プロパティを false に設定しても,同じ効果があります。

fgPendingRecords

変更を加えられたが適用されなかった(UpdateBatch メソッド)か取り消された(CancelBatch メソッド)行だけを表示するようにフィルタ処理します。

fgAffectedRecords

最後の更新の影響を受けた行だけを表示するようにフィルタ処理します。

fgFetchedRecords

現在の更新キャッシュの行だけを表示するようにフィルタ処理します。これは,データベースから行を取得する最後の呼び出しの結果です。

fgPredicate

削除された行だけを表示するようにフィルタ処理します。

fgConflictingRecords

変更が加えられたがその適用でエラーが発生したために未変更となった行だけを表示するようにフィルタ処理します。



Recordset.Filter プロパティを参照してください。

関連項目