【入門編】初心者向け:レコードセットを使ったフォーム上のコントロールへの値代入と更新 – Access VBA解析バイブル

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

脱・マクロ記録!Recordset(レコードセット)を操って「データの真髄」を書き換える技術

こんにちは。開発の現場へようこそ。

マクロの記録を使って「あ、動いた!」と喜んでいた時期は、エンジニアとしての素晴らしい第一歩です。でも、もしあなたが今、「フォームのテキストボックスに値を直接入れたいけれど、もっとスマートで、壊れにくい方法はないかな?」と考えているなら……おめでとうございます。あなたは今、「画面(UI)の操作」から「データ(Data)の操作」へとステップアップする境界線に立っています。

今日は、Access VBAにおける最強の武器の一つ、「Recordset(レコードセット)」を使ったデータの更新方法を伝授します。

これをマスターすれば、フォームの見た目に左右されず、裏側にある「真実のデータ」を自在に、そして安全に操れるようになりますよ。

なぜ「テキストボックス」を直接いじってはいけないのか?

初心者の多くは、次のようなコードを書きます。

' 初心者がやりがちな例
Me.txt顧客名 = "田中太郎"

これは「フォーム上のテキストボックス(コントロール)の表示を書き換える」命令です。一見動きますが、実はこれには2つの大きなリスクが潜んでいます。

1. 画面とデータの乖離(かいり): テキストボックスの値を書き換えても、それが「テーブル(元のデータ)」に正しく保存されるとは限りません。
2. 設計変更への弱さ: もし将来、テキストボックスの名前を `txtCustomerName` から `txtName` に変更したら、このコードは即座にエラーで動かなくなります。

プロのエンジニアは、画面(コントロール)をいじるのではなく、データそのもの(Recordset)に直接アクセスします。データさえ書き換えれば、フォームはそれを自動的に表示してくれるからです。

Recordset(レコードセット)とは何か?

Recordsetを一言で言うなら、「データベースの中に現れる、仮想的なカーソル(指先)」です。

テーブルという巨大な情報の海の中に、Recordsetという「指」を差し込み、「今、この行(レコード)を見ていますよ」という状態を作るイメージです。この「指」を使って、「この列の値を書き換えて!」と命令するのが、正しいデータの扱い方なのです。

実践:特定のレコードを安全に更新するステップ

では、具体的なシナリオで考えてみましょう。
「顧客管理フォームを開いていて、ボタンを押すと、現在表示されている顧客の『最終訪問日』を今日の日付に更新する」という処理です。

【黄金の5ステップ】

Recordsetを使った更新には、必ず決まった作法があります。

1. 宣言: Recordsetオブジェクトの器を作る。
2. オープン: テーブル(またはクエリ)に指(Recordset)を差し込む。
3. 移動: 更新したい特定のレコードを探し出す(`FindFirst`)。
4. 編集: 「編集モード」に入り、値を書き換え、確定する(`Edit` $\rightarrow$ `Update`)。
5. 後片付け: 指を抜いて、器を片付ける(`Close`)。

実装コード例

以下のコードを、フォームのボタンのクリックイベントなどに貼り付けてみてください。

Private Sub btnUpdateVisitDate_Click()
    ' --- 1. 変数の宣言 ---
    ' DAO(Data Access Objects)という、Access標準の操作方式を使います
    Dim db As DAO.Database
    Dim rs As DAO.Recordset
    Dim targetID As Long
    
    ' フォーム上で現在表示されている顧客のIDを取得(これが検索の鍵になります)
    ' ※コントロール名はご自身の環境に合わせて変更してください
    targetID = Me.txtCustomerID.Value
    
    ' エラーハンドリング(エラーが起きた時に止まらないようにするおまじない)
    On Error GoTo ErrorHandler

    ' --- 2. オープン ---
    Set db = CurrentDb ' 現在のデータベースをセット
    ' 「顧客テーブル」に対して、編集可能なモード(Dynaset)でRecordsetを開く
    Set rs = db.OpenRecordset("T_顧客マスタ", dbOpenDynaset)

    ' --- 3. 移動 ---
    ' FindFirstを使って、IDが一致するレコードを高速に検索します
    ' 「ID = 123」のような条件式を文字列で作ります
    rs.FindFirst "顧客ID = " & targetID

    ' もし見つからなかった場合の処理
    If rs.NoMatch Then
        MsgBox "対象のレコードが見つかりませんでした。", vbExclamation
        GoTo Cleanup
    End If

    ' --- 4. 編集 ---
    ' ここからが核心!「編集モード」への切り替え
    rs.Edit             ' 「今から書き換えますよ」という宣言
    rs.Fields("最終訪問日").Value = Date ' 値を今日の日付に書き換え
    rs.Update           ' 「書き換え完了!保存してください」という確定命令

    MsgBox "更新が完了しました!", vbInformation

' --- 5. 後片付け ---
Cleanup:
    ' 開いたRecordsetを閉じる(これを忘れると、データベースがロックされてしまいます!)
    If Not rs Is Nothing Then
        rs.Close
        Set rs = Nothing
    End If
    Set db = Nothing
    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
    Resume Cleanup
End Sub

ここが落とし穴!陥りやすい3つのエラー

プロへの道は、失敗の数だけあります。初心者が必ずと言っていいほどハマるポイントをまとめておきました。

① `.Update` を忘れる(「書き換えたはずなのに!」)

`rs.Edit` で編集を開始し、値を代入しても、最後に `rs.Update` を実行しなければ、変更はすべて破棄されます。「Editは注文、Updateは会計」だと覚えておいてください。会計をせずに店を出ることはできません。

② `.Close` を忘れる(「ファイルが開けない!」)

Recordsetを使い終わった後に `Close` しないと、Accessはそのテーブルを「誰かが使い続けている」と判断し、ロックをかけてしまいます。他のユーザーがデータを更新できなくなる致命的な問題につながるため、「開けたら必ず閉じる」が鉄則です。

③ `NoMatch` のチェック漏れ(「いきなりエラーで止まる!」)

`FindFirst` でレコードが見つからなかった場合、その後の `rs.Edit` を実行しようとするとエラーになります。必ず `If rs.NoMatch Then` で、見つかったかどうかを確認する癖をつけましょう。

まとめ:データの本質を掴もう

いかがでしたか?

「テキストボックスの値を書き換える」のは、あくまで「鏡に映った姿を変える」ようなものです。一方で、「Recordsetで更新する」のは、「鏡に映っている本人を動かす」ようなものです。

本物(データ)を動かす技術を身につければ、あなたの作ったアプリケーションの信頼性は飛躍的に高まります。

最初はコードが長く感じるかもしれませんが、この「宣言 $\rightarrow$ オープン $\rightarrow$ 検索 $\rightarrow$ 編集 $\rightarrow$ 確定 $\rightarrow$ 閉じる」というリズムは、Access VBAにおける「呼吸」のようなものです。何度も書いて、指に覚え込ませていきましょう。

ここをクリアすれば、Access VBAの基本はバッチリですよ。次の一歩を楽しみにしていますね!

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