【実務・中級編】【初心者向け】「Documents.Open」で大量の図面を順次処理する際の、メモリ消費を抑えるための基本的な「Close」タイミング – AutoCAD VBA解析バイブル

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

【極限の知見】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点を守るだけで、君の作成するツールは、同僚たちが「このツールは止まらない」と絶賛する、極めて堅牢なプロダクトへと進化するはずだ。

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