AccessのVBAでOn Error GoTo・Resume・Errオブジェクトでエラー処理を実装する|実務3パターン・デバッグ手順とMOS試験対策

AccessのVBAでマクロや自動化処理を組んでいると、テーブルが見つからない、フォームが開けない、型が一致しないといったランタイムエラーに遭遇します。エラー処理を書いていないと、そのたびに「実行時エラー」ダイアログが表示されて処理が止まり、エンドユーザーに赤いエラー画面が見えてしまいます。

本記事では、On Error GoTo・Resume・Errオブジェクトを使ったAccessのVBAエラー処理の基本構造を解説し、実務で使える3つのパターンをコード例とともに紹介します。AccessのVBAをひと段階クオリティアップしたい方の参考になる内容です。

AccessのVBAでOn Error GoTo・Resume・Errオブジェクトでエラー処理を実装する|実務3パターン・デバッグ手順とMOS試験対策 - 解説

目次

AccessのVBAエラー処理で使う3つの構文

VBAのエラー処理は「On Error」ステートメントで制御します。主に3種類あります。

構文 動作
On Error GoTo ラベル名 エラーが発生したら指定ラベルにジャンプ
On Error Resume Next エラーを無視して次の行へ進む
On Error GoTo 0 エラートラップを解除(既定の動作に戻す)

実務ではOn Error GoTo ラベル名が最も安全で推奨されるパターンです。On Error Resume Nextは「エラーが発生しても無視する」という意味なので、どこで何のエラーが起きたか追えなくなるリスクがあります。限定的な場所にのみ使いましょう。

On Error GoToの基本構造

エラー処理の基本的な骨格は次のとおりです。コードを3つのブロック(通常処理・早期脱出・エラーハンドラ)に分けて書くのがポイントです。

Sub サンプル処理()
    On Error GoTo ErrorHandler

    ' ここに通常の処理を書く
    Dim db As DAO.Database
    Set db = CurrentDb()
    db.Execute "UPDATE T_受注 SET ステータス = '処理済'"  ' 想定例

    MsgBox "処理が完了しました。"
    Exit Sub  ' 正常終了時はここでSubを抜ける

ErrorHandler:
    MsgBox "エラーが発生しました。" & vbCrLf & _
           "エラー番号: " & Err.Number & vbCrLf & _
           "詳細: " & Err.Description, vbCritical, "エラー"
End Sub

Exit Subが重要です。エラーが発生しなかったときにErrorHandlerブロックを実行してしまわないよう、通常処理の最後に必ずExit Subを書いてください。

Errオブジェクトの主要プロパティ

エラーが発生すると、VBAの組み込みオブジェクトErrにエラー情報がセットされます。

プロパティ 内容 利用例
Err.Number エラー番号(整数) エラーの種類を番号で分岐する
Err.Description エラーの説明文字列 MsgBoxでユーザーに説明を表示
Err.Source エラーが発生したオブジェクト名 ログに記録して原因追跡に使う

エラー番号はAccessのVBAでよく遭遇するものに規則性があります。たとえばエラー番号3011は「Accessはオブジェクトを見つけることができません」(テーブル名の誤りなど)、エラー番号3022は「インデックスが重複しています」(主キー重複など)です。エラーハンドラの中でErr.Numberを見て分岐を書くことで、より親切なエラーメッセージを出せます。

Resumeステートメントの3種類

エラーハンドラの中から処理を再開する方法は3種類あります。

構文 再開場所 用途
Resume エラーが発生した行を再実行 ユーザーが値を修正して再試行させる場合など
Resume Next エラー発生の次の行から再開 エラーを記録してそのまま続行させる場合
Resume ラベル名 指定ラベルの行から再開 クリーンアップ処理(Closeなど)を通してから終了する場合

最も安全なパターンはResume CleanUp(またはResume ExitLine)です。エラーが起きてもRecordsetやオブジェクトを確実にCloseしてからSubを終了できます。

実務3パターン

パターン1: Recordset処理をエラーハンドリング付きで安全に実行する

DAOのRecordsetを開いて処理する際、テーブル名の誤りや権限エラーが起きると中断します。エラーが起きてもRecordsetを確実にCloseするのがポイントです。

Sub レコード一括更新()
    Dim db As DAO.Database
    Dim rs As DAO.Recordset

    On Error GoTo ErrorHandler

    Set db = CurrentDb()
    Set rs = db.OpenRecordset("T_受注", dbOpenDynaset)

    Do Until rs.EOF
        rs.Edit
        rs!処理日 = Date()
        rs.Update
        rs.MoveNext
    Loop

    MsgBox "更新完了しました(" & rs.RecordCount & " 件)。"

CleanUp:
    If Not rs Is Nothing Then rs.Close
    Set rs = Nothing
    Set db = Nothing
    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました。" & vbCrLf & _
           Err.Number & ": " & Err.Description, vbCritical, "エラー"
    Resume CleanUp
End Sub

CleanUpラベルを用意してResume CleanUpで飛ばすことで、エラーの有無にかかわらずRecordsetが必ずCloseされます。

パターン2: エラー番号で分岐して親切なメッセージを出す

エラー番号を見て、ユーザー向けのわかりやすいメッセージに変換するパターンです。

Sub 受注データ登録(顧客ID As Long, 金額 As Currency)
    Dim db As DAO.Database

    On Error GoTo ErrorHandler

    Set db = CurrentDb()
    db.Execute "INSERT INTO T_受注 (顧客ID, 金額, 受注日) " & _
               "VALUES (" & 顧客ID & ", " & 金額 & ", #" & Format(Date(), "yyyy/mm/dd") & "#)"

    MsgBox "登録が完了しました。"
    Set db = Nothing
    Exit Sub

ErrorHandler:
    Select Case Err.Number
        Case 3022
            MsgBox "同じ顧客IDのレコードが既に存在します。", vbExclamation, "重複エラー"
        Case 3011
            MsgBox "テーブルが見つかりません。システム管理者に確認してください。", vbCritical, "テーブルエラー"
        Case Else
            MsgBox "予期しないエラーが発生しました。" & vbCrLf & _
                   Err.Number & ": " & Err.Description, vbCritical, "エラー"
    End Select
    Set db = Nothing
End Sub

エラー番号3022(重複エラー)など頻発するエラーは個別のCaseで受けると、ユーザーへの説明が格段に親切になります。

パターン3: エラーをテーブルに記録してログを残す

バッチ処理など誰も見ていない夜間実行のマクロでは、エラーが起きたことを後から確認できるようログテーブルに書き込みます。

Sub エラーログ記録(エラー番号 As Long, エラー説明 As String, 処理名 As String)
    Dim db As DAO.Database
    On Error Resume Next  ' ログ書き込み自体が失敗しても止めない
    Set db = CurrentDb()
    db.Execute "INSERT INTO T_エラーログ (発生日時, 処理名, エラー番号, エラー内容) " & _
               "VALUES (Now(), '" & 処理名 & "', " & エラー番号 & ", '" & エラー説明 & "')"
    Set db = Nothing
End Sub

Sub 夜間バッチ処理()
    On Error GoTo ErrorHandler
    ' 通常処理(省略)
    Exit Sub

ErrorHandler:
    Call エラーログ記録(Err.Number, Err.Description, "夜間バッチ処理")
    Resume Next
End Sub

ログ書き込みプロシージャ自体にはOn Error Resume Nextを使い、ログ書き込みが失敗してもバッチ全体は止めないようにしています。On Error Resume Nextはこのように副作用ゼロが確実な箇所に限定するのが使い方の原則です。

よくあるつまずきと対処法

On Error Resume Nextを全体に書いてエラーを見えなくする

プロシージャの先頭にOn Error Resume Nextを書いて「とりあえずエラーを無視」するコードは一般的によくあるつまずきです。エラーが起きても処理が続くため一見動いているように見えますが、後でデータが壊れていたり、想定外のレコードが挿入されていたりする原因になります。エラーは必ず可視化して対処しましょう。

エラーハンドラ内でErrがリセットされる

エラーハンドラ内で別のSubやFunctionを呼ぶと、Errオブジェクトの内容が上書きされることがあります。エラー情報を使い回したい場合は、ハンドラの先頭で変数に保存しておきましょう。

ErrorHandler:
    Dim errNum As Long
    Dim errMsg As String
    errNum = Err.Number
    errMsg = Err.Description
    ' ここ以降でerrNum・errMsgを使う

Resumeを使うと「Resumeを使う不正な場所」エラーになる

エラーが起きていないのにResumeを実行しようとするとエラーになります。ResumeはOn Error GoToが有効な状態でエラーハンドラから戻るためのステートメントです。通常処理ブロックには書かないようにしましょう。

MOS Access試験とエラー処理の関係

MOS Access 365試験(MO-500)の出題範囲はテーブル設計・クエリ・フォーム・レポート・マクロが中心です。VBAのエラー処理は試験の直接の出題対象ではありません。

ただし、MOS取得後に実務でAccessのデータベースを運用していくと、エラー処理を入れているかどうかがシステムの信頼性に直結します。フォームのボタンにエラー処理を入れるだけで、エンドユーザーの前に赤いエラー画面が出なくなり、問い合わせが大幅に減ります。VBAを少し書けるようになったら、次のステップとして取り組む価値のあるスキルです。

AccessのVBAでOn Error GoTo・Resume・Errオブジェクトでエラー処理を実装する|実務3パターン・デバッグ手順とMOS試験対策 - まとめ

まとめ:On Error GoTo基本パターン早見表

ステートメント 役割
On Error GoTo ErrorHandler エラートラップを有効化。エラーが起きたらErrorHandlerへジャンプ
Exit Sub(通常処理の最後) 正常終了時にErrorHandlerをスキップする
Err.Number / Err.Description エラーの種類と説明を取得してメッセージに使う
Resume CleanUp エラー後にオブジェクトをCloseするクリーンアップブロックへ戻る
Resume Next エラー発生の次行から続行(限定的に使用)
On Error GoTo 0 エラートラップを解除して既定動作に戻す

AccessのVBAでエラー処理を入れると、コード量は少し増えますが、業務で使えるデータベースアプリケーションとしての完成度が大きく上がります。まずはプロシージャ1本にOn Error GoTo ErrorHandlerとExit Sub・ErrorHandlerラベルの骨格を書くことから始めてみましょう。

PR

たった1秒で仕事が片づくExcel自動化の教科書【改訂第3版】

Excel VBAの考え方はAccessのVBAにも通じる部分が多い一冊です。エラー処理を含む自動化スクリプトの書き方・デバッグの考え方を体系的に学びたい方のステップアップに役立ちます。

AccessのVBAをさらに学ぶ
AccessのVBA入門(DoCmd・MsgBox・変数宣言)やDAO RecordsetのVBA実践入門の記事も合わせてご覧ください。エラー処理と組み合わせると、より堅牢なデータ操作スクリプトを作れます。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次