英語で読む

次の方法で共有


CDaoRecordset::FindFirst

最初のレコードを検索するには、このメンバー関数を呼び出して、指定した条件に一致します。

BOOL FindFirst(
   LPCTSTR lpszFilter 
);

パラメーター

  • lpszFilter
    レコードを見つけるために使用される文字列式 (Word WHEREのない SQL ステートメントの WHERE 句など)。

戻り値

一致するレコードがある場合はゼロ以外の場合は 0。

解説

FindFirst のメンバー関数でレコードセットの先頭から検索を開始し、レコードセットの最後に検索します。

レコード間の移動に、(特定の条件を満たす) を使用して移動の操作の 1 つがを検索にすべてのレコードを含める場合は。テーブル タイプのレコードセットのレコードを探すには、Seek のメンバー関数を呼び出します。

条件に合致するレコードがキャッチされない場合、現在のレコード ポインターは不定のと FindFirst のゼロを返します。レコードセットが基準を満たす複数のレコードが含まれている場合、FindFirst は最初の出現箇所を検索します FindNext、次の生成などを検索します。

Caution メモ注意

現在のレコードを編集した場合は、更新 のメンバー関数を呼び出すことで変更を保存する必要があります。別のレコードに移動する前にします。別のレコードに更新せずに実行され、変更は警告なしに失われます。

[検索] のメンバー関数は、場所から次の表で指定した方向に検索します:

検索操作

Begin

検索の方向

FindFirst

レコードセットの先頭

レコードセットの最後

FindLast

レコードセットの最後

レコードセットの先頭

FindNext

現在のレコード

レコードセットの最後

FindPrevious

現在のレコード

レコードセットの先頭

[!メモ]

FindLastを呼び出すと、Microsoft Jet データベース エンジンは、調査を開始する前に完全に実行していない場合、レコードセットに設定します。最初の検索は、後で検索に時間がかかる場合があります。

ただし、検索の 1 つを使用して操作は、MoveFirstMoveNextを呼び出してと条件を指定しないで最初または次のレコードの現在値を行う同じ。移動の操作を検索操作の後に入力できます。

検索操作を使用するときは、以下を考慮する:

  • [検索] がゼロ以外の値を返した場合、現在のレコードは定義されません。この場合、有効なレコードに対して現在のレコード ポインターを設定する必要があります。

  • 前方スクロール専用スクロール スナップショット タイプのレコードセットの検索操作を使用できません。

  • Microsoft Jet データベース エンジンの米国の.. バージョンを使用しない場合でも、日付を格納するフィールドを検索するときに、米国.. の日付形式が必要です (月日) を使用する; それ以外の場合、一致するレコードが見つからない場合があります。

  • 検索操作を使用して、遅くなることを ODBC データベースと大きなダイナセットを使用する場合は、検出できる、特に大きなレコードセット、を使用したとき。ORDERBY または WHERE のカスタマイズされた句、パラメーター クエリ、または特定のインデックスのレコードを取得する CDaoQuerydef のオブジェクトと、SQL クエリを使用すると、パフォーマンスが向上します。

関連情報については、「FindFirst、FindLast、FindNext の DAO ヘルプ FindPrevious のメソッド」"を参照してください。

必要条件

Header: afxdao.h

参照

関連項目

CDaoRecordset クラス

階層図

CDaoRecordset::Find

CDaoRecordset::FindLast

CDaoRecordset::FindNext

CDaoRecordset::FindPrev