【入門編】初心者向け:レコードセットの検索機能「FindFirst」と「NoMatch」プロパティの活用 – Access VBA解析バイブル

スポンサーリンク
スポンサーリンク

【Access VBAの極意】「見つからない」を恐れない。FindFirstとNoMatchで操るレコード検索の真髄

こんにちは。Access VBAという広大な海へようこそ。

マクロの記録機能を使って「動くもの」を作れるようになったあなた。素晴らしい一歩を踏み出しましたね。でも、今のあなたは「もし、探しているデータがなかったらどうしよう?」という不安を、どこかで感じていませんか?

プログラムの世界では、「正常に動くこと」と同じくらい、「想定外の事態(データが見つからない等)に、優雅に、かつ安全に対処すること」が重要視されます。

今日は、レコードセット(Recordset)を自在に操るための必須テクニック、`FindFirst` メソッドと、その相棒である `NoMatch` プロパティについて、その本質を紐解いていきましょう。ここをマスターすれば、あなたのコードは「ただ動くもの」から「プロが書いた堅牢なシステム」へと進化します。

1. なぜ「ループ」ではなく「FindFirst」なのか?

初心者の多くは、特定のデータを探そうとする時、以下のような「力技」を考えがちです。

> 「レコードを1件目から順番に見ていって、もし条件に合致したら、そのデータを採用する」

これをプログラミングでは「ループ(繰り返し)処理」と呼びます。確かにこれでも動きます。しかし、データが10件なら一瞬ですが、10万件あったらどうでしょう? プログラムは止まったように重くなるでしょう。

ここで登場するのが `FindFirst` です。

`FindFirst` は、データベースのインデックス(索引)を活用して、条件に一致するレコードへ「一気にジャンプする」命令です。例えるなら、辞書を1ページずつめくって単語を探すのが「ループ」で、索引を使って目的のページをパッと開くのが「FindFirst」です。

圧倒的なスピード。それが `FindFirst` を使う最大の理由です。

2. `FindFirst` の動きと「ポインタ」の概念

`FindFirst` を理解する上で欠かせないのが、「カーソル(ポインタ)」という考え方です。

レコードセットの中には、今どのレコードを見ているかを示す「目印(カーソル)」が存在します。`FindFirst` を実行すると、この目印が条件に一致したレコードの場所まで、シュッと移動します。

しかし、ここで問題が発生します。
「もし、条件に合うデータが一つもなかったら、目印はどこに行くのか?」

答えは、「どこにも移動できない(元の場所か、あるいは宙に浮いた状態)」です。この「見つからなかった状態」を検知できないまま、見つかったものとして処理を続行しようとすると、Accessは「そんなレコードはありません!」とエラーを吐いて止まってしまいます。

これこそが、初心者が最も陥りやすい罠なのです。

3. 守護神 `NoMatch` プロパティ

この罠を回避するために用意されているのが、`NoMatch` プロパティです。

`NoMatch` は、直前に行った検索(`FindFirst` など)の結果、「一致するものがなかったかどうか」を教えてくれる Boolean型(True か False)のプロパティです。

  • `NoMatch = True` : 「残念!見つかりませんでした」
  • `NoMatch = False` : 「おめでとう!見つかりました」

使い方のイメージはこうです。
1. `FindFirst` で検索をかける。
2. すぐに `NoMatch` をチェックする。
3. `True` なら「エラーメッセージを出して終了」、`False` なら「見つかったレコードに対して処理を行う」。

この「検索 ➡ 検証 ➡ 実行」というステップこそが、プロフェッショナルの作法です。

4. 実践:堅牢な検索コードのテンプレート

それでは、実際に現場でそのまま使えるレベルのコードを見てみましょう。
「社員IDを入力して、その社員の氏名を表示する」というシナリオを想定します。

Sub SearchEmployeeExample()
    Dim db As DAO.Database
    Dim rs As DAO.Recordset
    Dim targetID As Long
    Dim searchCriteria As String

    ' 1. 事前準備
    Set db = CurrentDb
    ' 社員テーブルを開く
    Set rs = db.OpenRecordset("T_社員マスタ", dbOpenDynaset)
    
    ' 検索したいID(本来はフォームの入力値などから取得します)
    targetID = 101 
    
    ' 2. 検索条件の組み立て
    ' 数値型の場合の書き方(文字列の場合は ' を使う点に注意!)
    searchCriteria = "社員ID = " & targetID

    ' 3. 検索の実行
    ' FindFirst メソッドで条件に一致する最初のレコードへジャンプ
    rs.FindFirst searchCriteria

    ' 4. 【最重要】検索結果の判定
    ' NoMatchプロパティを確認して、見つかったかどうかを判断する
    If rs.NoMatch Then
        ' --- 見つからなかった場合の処理 ---
        MsgBox "指定された社員ID [" & targetID & "] は見つかりませんでした。", vbExclamation, "検索失敗"
    Else
        ' --- 見つかった場合の処理 ---
        ' ここまで到達したということは、rsのカーソルは目的のレコードに移動している
        MsgBox "社員名: " & rs!氏名 & " 様が見つかりました。", vbInformation, "検索成功"
        
        ' 必要に応じて、見つかったレコードの値を更新するなどの処理を行う
        ' rs.Edit
        ' rs!最終アクセス日 = Now()
        ' rs.Update
    End If

    ' 5. 後片付け(リソースの解放)
    ' 開いたレコードセットは必ず閉じる。これがメモリリークを防ぐ鉄則
    rs.Close
    Set rs = Nothing
    Set db = Nothing
    
End Sub

コードの解説ポイント

  • `searchCriteria` の組み立て: SQLのWHERE句と同じ書き方になります。数値ならそのまま、文字列なら `’`(シングルクォーテーション)で囲む必要があります。
  • `If rs.NoMatch Then`: ここがこのコードの心臓部です。検索に失敗した瞬間に `True` になるので、ここで処理を分岐させます。
  • `rs.Close`: データベース操作において、使い終わったオブジェクトを閉じることは、システムの安定性を保つための「作法」です。

5. まとめ:ここをクリアすれば、あなたはもう初心者ではない

最後に、今日学んだことを振り返りましょう。

1. `FindFirst` は「インデックスを使った高速なジャンプ」である。
2. 検索に失敗すると、カーソルは迷子になり、エラーの原因になる。
3. `NoMatch` プロパティを使って、必ず「見つかったかどうか」を判定する。
4. 「見つからなかった時」の処理を書いておくことが、ユーザーに優しいシステムを作るコツ。

「データがあるはずだ」という思い込みを捨て、「データがないかもしれない」という前提でコードを書く。この視点を持てた時、あなたのVBAスキルは一段上のステージへと到達します。

一歩ずつ、確実に。
次はもっと複雑な、レコードの更新(Edit/Update)の制御についてお話ししましょう。

また次の記事でお会いしましょう!

タイトルとURLをコピーしました