【VBAリファレンス|実務向け】ワークシートのコード名を取得する(CodeNameプロパティ)|Excel VBA

スポンサーリンク

なぜ「コード名」を理解する必要があるのか?

Excel VBAでシートを操作する際、多くの方が Worksheets(“Sheet1”) のように「シート名」で指定しているのではないでしょうか。しかし、この方法には大きな落とし穴があります。ユーザーがシート名を変更してしまった途端、マクロがエラーを起こして停止してしまうのです。

そこで重要になるのが「コード名(CodeName)」です。コード名を利用すれば、シート名がどれだけ変更されても、プログラム側は確実にそのシートを特定できます。実務で「壊れにくいマクロ」を作るためには、必須の知識と言えるでしょう。

基礎知識:シート名とコード名の違い

Excelには、シートを識別するための名前が2種類存在します。

1. シート名(Nameプロパティ): Excel画面下のタブに表示されている名前です。ユーザーが自由にダブルクリックで変更できます。
2. コード名(CodeNameプロパティ): VBE(Visual Basic Editor)のプロパティウィンドウで確認できる、システム内部的な名前です。シートの作成時に自動付与されますが、ユーザーが通常操作で変更することは困難です。

プログラムからシートを操作する際、Sheet1.Range(“A1”) と記述すると、VBAは「シート名に関わらず、コード名がSheet1であるシート」を対象に処理を行います。これにより、運用者がシート名を変更してもマクロが動かなくなるリスクを回避できるのです。

実装:コード名を取得・活用する

まずは、現在のブックに存在する全シートの「シート名」と「コード名」を対比させて確認してみましょう。以下のコードを実行すると、イミディエイトウィンドウに一覧が出力されます。

サンプルプログラム

以下のコードを標準モジュールにコピーして実行してください。

Sub GetSheetCodeName()
‘ ワークシートオブジェクトをループ処理します
Dim sh As Worksheet

Debug.Print “— シート名とコード名の対応一覧 —”

For Each sh In Worksheets
‘ sh.Nameはタブの名前、sh.CodeNameはシステム内部の名前
Debug.Print “シート名: ” & sh.Name & ” / コード名: ” & sh.CodeName
Next sh

MsgBox “イミディエイトウィンドウに一覧を出力しました。”
End Sub

応用・注意点:現場で陥りやすいバグの回避策

コード名を活用する際、以下の点に注意してください。

1. 動的なシート指定には向かない
コード名は開発段階で固定されるため、プログラム実行時にユーザーが新しく作成したシートに対しては、コード名を直書きすることができません。動的に追加されたシートを操作する場合は、Worksheets(Worksheets.Count) のようにインデックス番号や、追加直後のオブジェクト変数を利用する必要があります。

2. コード名を変更する際は慎重に
VBEのプロパティウィンドウからコード名を変更することは可能ですが、あまり推奨されません。チーム開発などでコード名が「DataSheet」「InputSheet」のように明示的である場合は読みやすくなりますが、あまり頻繁に変更すると、既存のコードとの整合性が取れなくなるリスクがあります。

3. メンテナンス性を高める
現場で「シート名が変わってマクロが動かなくなった!」というトラブルを防ぐ第一歩は、このCodeNameプロパティを正しく理解し、重要なシート操作において「シート名」への依存を減らすことです。ぜひ、明日からの開発で取り入れてみてください。

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