【極限の知見】AutoCAD VBAにおける大量図面処理の鉄則:`Documents.Open` のメモリ爆発を回避する「完全なる解放」の作法
「10枚、20枚の図面を処理するプログラムは完璧に動いた。しかし、100枚、500枚と増やした途端、AutoCADが沈黙し、メモリ不足でクラッシュする……」
もし君が今、このような壁にぶち当たっているとしたら、それは君のロジックが間違っているのではない。「オブジェクトのライフサイクル」に対する設計思想が欠落しているのだ。
業務自動化の現場において、大量のDWGファイルを順次処理するツールは「喉から手が出るほど欲しい」ものだ。しかし、不用意に `Documents.Open` をループ内で回す行為は、設計者として「時限爆弾」を仕掛けているのと同義である。
本稿では、単なる「Closeの書き方」ではない。AutoCADという巨大なソフトウェアのメモリ管理メカニズムを掌握し、堅牢なプロダクションコードを書き上げるための「極限の知法」を伝授する。
1. なぜ「Close」だけでは不十分なのか?
多くの初学者は、以下のようなコードを書く。
' 典型的な「失敗する」設計例
For Each filePath In fileList
Set doc = ThisDrawing.Application.Documents.Open(filePath)
' --- 何らかの処理 ---
doc.Close SaveChanges:=True
Next filePath
これでは、図面が100枚あれば、AutoCADのメモリ領域には「閉じられたはずの図面の残骸(Zombie Objects)」が蓄積され続ける。
致命的な原因:COM参照カウントの仕組み
AutoCAD VBAは、COM(Component Object Model)技術に基づいている。`Documents.Open` で取得した `Document` オブジェクトは、VBA内の変数 `doc` がそのオブジェクトを「参照」している限り、メモリ上に居座り続ける。
`doc.Close` を実行しても、VBA側の変数 `doc` がオブジェクトを指し示したまま(参照を保持したまま)では、メモリ解放のトリガーが完全には引かれない。 これが、ループが進むにつれてメモリ消費が指数関数的に増大し、最終的にAutoCADがクラッシュする正体である。
2. 堅牢な設計:リソース解放の「黄金サイクル」
プロフェッショナルな設計では、オブジェクトのライフサイクルを以下の4ステップで厳格に管理する。
1. Open: オブジェクトを取得する。
2. Process: 業務ロジックを実行する。
3. Close: AutoCAD上の図面を閉じる。
4. Release: VBA側の参照を完全に断ち切る(`Set Nothing`)。
さらに、OSレベルでのメモリ整理を促すために `DoEvents` を挟む。これが、長時間稼働するツールにおける「作法」だ。
3. プロダクション・コード例:大量図面処理のテンプレート
以下に、実務でそのまま利用できるレベルの、堅牢なループ処理構造を示す。エラーハンドリング、メモリ解放、そして処理の安定性を担保した設計だ。
Option Explicit
''' <summary>
''' 指定されたパスのリストに従って図面を一括処理するメインルーチン
''' </summary>
Public Sub BatchProcessDrawings(ByVal fileList As Collection)
Dim acadApp As Object
Dim targetDoc As Object
Dim filePath As Variant
' AutoCADアプリケーションオブジェクトの取得
Set acadApp = ThisDrawing.Application
On Error GoTo ErrorHandler
' --- ループ開始 ---
For Each filePath In fileList
Debug.Print "Processing: " & filePath
' 1. Open: 図面を開く
' ※エラーハンドリングにより、ファイル破損時などの異常停止を防ぐ
Set targetDoc = acadApp.Documents.Open(filePath)
' 2. Process: 業務ロジックの呼び出し
' 実際の処理は別関数に切り出し、単一責任の原則を守る
Call ExecuteBusinessLogic(targetDoc)
' 3. Close: 図面を保存して閉じる
' 引数に True を指定することで変更を保存
targetDoc.Close True
' 4. Release: 【極めて重要】参照を完全に破棄する
' これを行わないと、メモリ上にオブジェクトが残存し続ける
Set targetDoc = Nothing
' OSに制御を一時的に戻し、メモリのクリーンアップを促す
DoEvents
Next filePath
MsgBox "全件の処理が正常に完了しました。", vbInformation
Exit Sub
ErrorHandler:
' 個別の図面エラーで全体のプロセスを止めないための設計
MsgBox "エラーが発生しました。ファイル: " & filePath & vbCrLf & _
"Error No: " & Err.Number & vbCrLf & _
"Description: " & Err.Description, vbCritical
' エラー時もオブジェクト解放を試みる
If Not targetDoc Is Nothing Then
On Error Resume Next
targetDoc.Close False ' 保存せずに閉じる
Set targetDoc = Nothing
On Error GoTo 0
End If
Resume Next ' 次のファイルへ進む(要件に応じて検討)
End Sub
''' <summary>
''' 個別の図面に対する具体的な業務ロジック
''' </summary>
Private Sub ExecuteBusinessLogic(ByVal doc As Object)
' ここに図面内のレイヤー操作や属性抽出などのロジックを記述
' 注意: ThisDrawing は使用せず、必ず引数の doc を使用すること
' 例: 全てのレイヤーを走査するなどの処理
Dim lay As Object
For Each lay In doc.Layers
' ロジック...
Next lay
End Sub
4. アーキテクトからの警告:見落としがちな3つの落とし穴
コードが綺麗であっても、設計思想が揺らいでいればバグは発生する。以下の3点には細心の注意を払え。
① `ThisDrawing` の乱用禁止
ループ内で複数の図面を扱う際、コード内で `ThisDrawing` を使用してはならない。`ThisDrawing` は「現在アクティブな図面」を指す。`Documents.Open` で図面を切り替えた瞬間、`ThisDrawing` が指す対象が変わってしまうため、予期せぬ図面に対して操作を行ってしまう危険がある。常に、変数(例:`targetDoc`)を通じてオブジェクトを操作せよ。
② 外部連携(Excel/DB)のタイミング
もし図面処理のたびにExcelへの書き込みやデータベースへの接続を行っているなら、その「接続の開閉」にも注意せよ。
- 悪い例: ループの中で毎回 `Excel.Application` を `New` して `Quit` する(オーバーヘッドが甚大)。
- 良い例: ループの外で接続を確立し、すべての処理が終わった後に一括で切断する。
③ バージョン互換性の壁
`Documents.Open` は、現在のAutoCADバージョンより新しいバージョンのDWGを開こうとするとエラーを吐く。大量処理を行う前に、ファイルリストのバージョンチェックを行う、あるいは「開けなかった場合にどうスキップするか」のリカバリ設計を組み込んでおくことが、プロの仕事だ。
まとめ:エンジニアとしての矜持
「動けばいい」というコードは、現場では「負債」となる。
特にAutoCADのようなリソース消費の激しいアプリケーションを扱う場合、「いかにメモリを使い切らないか」という引き算の設計こそが、ツールの寿命を決める。
1. `Set Nothing` を怠るな。
2. `DoEvents` でOSに呼吸をさせろ。
3. `ThisDrawing` に頼らず、オブジェクトを明示的に扱え。
この3点を守るだけで、君の作成するツールは、同僚たちが「このツールは止まらない」と絶賛する、極めて堅牢なプロダクトへと進化するはずだ。
