Data.DB.TDataSet.FindFirst

• 親: TDataSet

Delphi

function FindFirst: Boolean;

C++

bool __fastcall FindFirst();

プロパティ

種類	可視性	ソース	ユニット	親
function	public	Data.DB.pas Data.DB.hpp	Data.DB	TDataSet

説明

フィルタを考慮しつつ、データセットを最初のレコードまで移動する、仮想メソッドを実装します。

FindFirst は、フィルタを使用して最初のレコードを検索するため、FindNext、FindLast、FindPrior と共に使用されることを想定しています。例を参照してください。

メモ：

• この関数は、TFDTable のLive Data Windows モードに対しては実装されていません。
• データセットを移動するには、通常は First、Last、Next、Prior を使用します。

下位クラスは FindFirst をオーバーライドし、効力のフィルタに配慮しつつ、最初のレコードをアクティブにできるようにします。下位クラスでは、FindFirst は次を返します：

• True -- アクティブ レコードが正常に変更された場合。
• False -- アクティブ レコードが正常に変更されなかった場合。

例：

このコード スニペットでは、フィルタ式を使用するレコードを、FindFirst および FindNext を使用して検索する方法を示しています：

Delphi：

FDQuery1.Filter := 'amount >= 10000';
if FDQuery1.FindFirst then
   repeat
    // do something
until not FDQuery1.FindNext;

C++：

FDQuery1->Filter="amount >= 10000";
if (FDQuery1->FindFirst()){
   do {
    // do something
   }
   while (FDQuery1->FindNext());
}

関連項目

• Data.DB.TDataSet.Filter
• Data.DB.TDataSet.Filtered
• Data.DB.TDataSet.OnFilterRecord
• Data.DB.TDataSet.FindLast
• Data.DB.TDataSet.FindNext
• Data.DB.TDataSet.FindPrior
• Data.DB.TDataSet.First