【Excel】VBAマクロの「コンパイルエラー」が出る!Excelの参照設定不足を修正する手順

Excel VBAマクロを実行した際に「コンパイルエラー」が表示されることがあります。このエラーは、マクロが参照しているライブラリが見つからない場合に発生します。原因を特定し、参照設定を正しく行うことで、この問題を解決できます。この記事では、Excel VBAでコンパイルエラーが発生する原因と、参照設定を修正する具体的な手順を解説します。

参照設定が不足していると、コードが正しくても実行時にエラーが発生し、マクロの利用を阻害します。本記事を読むことで、エラーの原因を理解し、参照設定を適切に行えるようになります。

コンパイルエラーの原因と仕組み

VBAマクロは、Excel本体だけでなく、様々な外部ライブラリ(DLLファイルなど)の機能を利用することがあります。これらのライブラリは「参照」としてVBAプロジェクトに登録されており、コードがこれらのライブラリの機能を使用する際に必要となります。例えば、特定のオブジェクトモデル(Accessデータベースの操作など)や、Windows API関数を利用する場合などです。

「コンパイルエラー」の中でも、参照設定が不足している場合に発生するエラーは、VBAコードの構文自体に誤りがあるのではなく、コードが利用しようとしている外部ライブラリの機能が見つからないことが原因です。この状態では、VBAコードは正常にコンパイル(機械語に翻訳)されず、実行できません。エラーメッセージには、しばしば「Sub or Function not defined」といった内容が表示されます。

参照設定不足によるコンパイルエラーを修正する手順

1. VBAエディタを開く
   Excelでマクロが含まれるファイルを開き、キーボードの「Alt」キーと「F11」キーを同時に押してVBAエディタ(Microsoft Visual Basic for Applications)を開きます。
2. 参照設定ダイアログを表示する
   VBAエディタのメニューバーから「ツール」をクリックし、「参照設定」を選択します。
3. 不足している参照を探す
   表示された「参照設定」ダイアログボックスで、リストの中から「参照不可」または「Missing」と表示されている項目を探します。これらが、現在不足している、またはリンクが切れている参照ライブラリです。
4. 不足している参照を削除する
   「参照不可」と表示されている項目を選択し、「削除」ボタンをクリックしてリストから削除します。
5. 必要な参照を追加する
   次に、マクロが依存しているライブラリを「参照可能なライブラリ」の中から探します。ダイアログボックスの「利用可能な参照」リストをスクロールするか、「参照」ボタンをクリックして、該当するDLLファイルなどを探します。例えば、Microsoft ActiveX Data Objects x.x Library(ADO)やMicrosoft Scripting Runtimeなどがよく使われます。
6. 参照にチェックを入れる
   見つけた必要なライブラリのチェックボックスにチェックを入れ、「OK」ボタンをクリックしてダイアログを閉じます。
7. VBAコードのコンパイルを試す
   VBAエディタのメニューバーから「デバッグ」をクリックし、「コンパイル」を選択します。エラーが発生しなければ、参照設定は正常に行われています。
8. マクロを実行して確認する
   Excelシートに戻り、マクロを実行して、コンパイルエラーが解消されたか確認します。

参照設定不足でよくある症状と追加の対処法

「Sub or Function not defined」エラーが表示される

このエラーメッセージは、VBAコード内で使用されているプロシージャ(SubまたはFunction)が見つからないことを示します。参照設定が不足している場合、そのプロシージャが別のライブラリに含まれている可能性があります。

対処法:

1. エラー箇所の特定
   VBAエディタでコードを実行した際に、エラーが発生した行がハイライトされます。
2. 使用されているオブジェクトの確認
   ハイライトされた行や、その周辺のコードを確認し、どのオブジェクトやメソッドが使用されているかを特定します。
3. 必要な参照の追加
   特定したオブジェクトやメソッドが属するライブラリを「参照設定」ダイアログから探し、チェックを入れて追加します。例えば、「Microsoft ActiveX Data Objects x.x Library」はADO機能、「Microsoft Scripting Runtime」はFileSystemObjectなどを使用する際に必要です。

「ユーザー定義型は定義されていません」エラーが表示される

このエラーは、コード内で使用されているユーザー定義型(Type…End Typeで定義される構造体など)や、外部ライブラリで定義されている型が見つからない場合に発生します。外部ライブラリの参照が不足していることが原因である可能性が高いです。

対処法:

1. エラー箇所と型名の確認
   エラーが発生しているコード行を確認し、どのユーザー定義型または外部型が使用されているかを特定します。
2. 参照設定の確認と追加
   その型が定義されている可能性のあるライブラリを「参照設定」ダイアログから探し、追加します。例えば、特定のCOMコンポーネントを使用している場合、そのコンポーネントに関連する参照を追加する必要があります。
3. コードの再配置
   もしユーザー定義型が別の標準モジュールに定義されている場合は、そのモジュールが参照されているか、またはコード全体が正しく配置されているかを確認します。

参照設定が勝手に解除される場合

Excelファイルを開くたびに参照設定が解除されてしまう、あるいはマクロ実行時に再度参照設定を求められることがあります。これは、ファイルが保存された環境と、現在開いている環境で参照ライブラリのパスやバージョンが異なる場合に発生しやすいです。

対処法:

1. 参照ライブラリのパス確認
   「参照設定」ダイアログで、各ライブラリのパスを確認します。複数のバージョンが存在する場合、意図しないバージョンが選択されている可能性があります。
2. 絶対パスではなく、相対パスまたは登録済みのライブラリを使用する
   可能であれば、特定のファイルパスに依存しない、Excelに標準で組み込まれている、またはシステムに登録済みのライブラリを使用するようにコードを修正します。
3. マクロセキュリティ設定の確認
   Excelのマクロセキュリティ設定が、参照ライブラリへのアクセスを制限していないか確認します。通常、参照設定自体はセキュリティ設定の影響を受けにくいですが、関連する機能によっては影響がある可能性も考慮します。
4. VBAProjectの再登録
   まれに、VBAProject自体が破損している可能性もあります。この場合は、マクロを新しいExcelブックにコピー&ペーストし直すことで解決することがあります。

参照設定の確認と管理のポイント

参照設定は、VBAマクロが正しく動作するために不可欠な要素です。特に、他のユーザーとExcelファイルを共有する場合や、異なるバージョンのOffice環境でマクロを実行する場合には、参照設定の管理が重要になります。

利用可能な参照ライブラリの種類

Excel VBAで参照設定できるライブラリは多岐にわたります。代表的なものを以下に示します。

ライブラリ名	主な用途	参照不可になりやすいか
Microsoft Visual Basic for Applications Extensibility 5.3	VBAプロジェクト自体の操作(コードの追加・削除など)	低い
Microsoft Excel Object Library	Excelのオブジェクト(Workbook, Worksheet, Rangeなど)の操作	非常に低い
Microsoft ActiveX Data Objects x.x Library (ADO)	データベース(Access, SQL Serverなど)へのアクセス、データ操作	中程度(Accessのバージョン依存など)
Microsoft Scripting Runtime	ファイルシステム操作(フォルダ作成、ファイルコピーなど)	低い
Microsoft DAO 3.6 Object Library	Accessデータベースの操作(ADOより古い)	中程度(Accessのバージョン依存など)
Microsoft Forms 2.0 Object Library	ユーザーフォームの操作	低い
OLE Automation	COMオブジェクトとの連携	低い

これらのライブラリは、Excelのインストール状況や、追加でインストールされたソフトウェア(Microsoft Accessなど)によって利用可能かどうかが変わります。マクロが依存するライブラリを正確に把握することが、参照設定のトラブルシューティングの第一歩です。

参照設定のベストプラクティス

参照設定を管理する上で、いくつかのベストプラクティスがあります。

参照設定を最小限にする

マクロが必要とするライブラリのみを参照設定します。不要な参照が多いと、ファイルサイズが増加したり、意図しないライブラリのバージョンが優先されたりする可能性があります。

バージョン管理に注意する

特にADOやDAOなど、データベース関連のライブラリはバージョンによって機能が異なることがあります。マクロを作成した環境と、実行する環境で同じバージョンのライブラリが利用可能であることを確認します。可能であれば、より新しいバージョンや、より汎用的なバージョンを選択するのが望ましいです。

Windows APIの使用を検討する

一部の機能(例えば、特定のダイアログボックスの表示や、高度なファイル操作など)は、Windows API関数を呼び出すことで実現できます。Windows APIは通常、Excelの標準ライブラリとして参照設定なしで利用できるため、参照設定の依存性を減らすことができます。ただし、API関数の利用はより高度な知識を要します。

早期束縛と遅延束縛の使い分け

参照設定されたライブラリのオブジェクトを使用する方法には、「早期束縛(Early Binding)」と「遅延束縛(Late Binding)」があります。

早期束縛は、VBAエディタで参照設定が完了しているライブラリのオブジェクトを使用する方法です。コンパイル時に型チェックが行われるため、コードの実行速度が速く、コード補完機能(IntelliSense)が利用できるというメリットがあります。しかし、参照設定が必須となります。

遅延束縛は、参照設定を行わずに、`CreateObject`関数などを使ってオブジェクトを生成し、そのメソッドやプロパティを呼び出す方法です。参照設定が不要なため、異なる環境での互換性が高まります。しかし、コンパイル時の型チェックが行われないため、実行時エラーが発生しやすく、コード補完機能も利用できません。

参照設定不足でコンパイルエラーが発生している場合は、早期束縛で記述されている可能性が高いです。もし参照設定を避けたい場合は、コードを遅延束縛で書き直すことも検討できます。

例えば、ADOオブジェクトを遅延束縛で利用する場合、以下のように記述します。

Dim cn As Object ' 早期束縛なら ADODB.Connection
Set cn = CreateObject("ADODB.Connection")

この方法であれば、「Microsoft ActiveX Data Objects x.x Library」の参照設定がなくてもADOConnectionオブジェクトを利用できます。

まとめ

Excel VBAで「コンパイルエラー」が発生し、その原因が参照設定不足である場合、VBAエディタの「参照設定」ダイアログから不足しているライブラリを追加することで解決できます。エラーメッセージや、コードで使用されているオブジェクトを特定し、適切なライブラリをチェックボックスで有効化してください。参照設定を正しく管理することで、マクロの実行エラーを防ぎ、安定した動作を実現できます。次回のマクロ作成時には、使用するライブラリを意識し、早期束縛と遅延束縛の使い分けも検討してみましょう。

📊

Excelトラブル完全解決データベースこの記事以外にも、様々なエラー解決策をまとめています。困った時の逆引きに活用してください。

🏆

超解決 Excel検定 あなたのExcel実務能力を3分で測定！【1級・2級・3級】