Office オートメーションで割り当てたオブジェクトを解放する - Part2

Article
02/28/2012

※ この記事は以下の Office サポートフォーラムに移行しました。 https://social.msdn.microsoft.com/Forums/ja-JP/0d9c6273-bade-4f6a-a0de-5adb748d15eb/office-part2

こんにちは、Office 開発系サポート森　健吾 (kenmori) です。

今回の投稿では、Office オートメーションの実装コードで割り当てたオブジェクトを解放する – Part1 の続編を記載いたします。続編では、前回の投稿でベストプラクティスとして紹介した解放処理に対して解説を実施した後、正しくオブジェクト解放を実施しない場合に生じる影響についてご紹介します。

最初に、オブジェクト解放漏れがあると、主に以下のような事象があるということは先に述べておきます。

・意図とは異なる COM オブジェクトに接続され、想定とは異なる結果を返し、アプリケーションの動作に予期せぬ影響を与えます。
・通常のメソッド実行にも関わらず COMException 等の例外が返さることがあります。
・イベント呼び出し時にフリーズすることがあります。
・Office の内部処理 (例. 終了時の処理など) に予期せぬ影響を及ぼすことがあります。
・解放漏れのオブジェクトがメモリを圧迫します。

オブジェクトの解放漏れと聞いて、誰もが最初に思いつくメモリ圧迫などのパフォーマンスへの影響以外にも実に様々な問題の要因となります。今回は、この投稿を読み終えた後、なぜそうなるかが理解できるようになることを目標とします。なお、幅広い読者層を想定して、可能な限りわかりやすい記述を心掛けます。そのため、なるべく簡略化した説明にするためにより一般的な内容だけにフォーカスし、細かな説明等は省いております。フィードバック等がありましたらお知らせください。

まずは、Part 1 で確認したベストプラクティスのコードを分析しましょう。

1. ベスト プラクティスのコードを分析する

1) .NET における Interop COM オブジェクトの生成について

New 演算子で Excel.Application クラス等を生成すると、RCW (ランタイム呼び出し可能ラッパー) も生成され COM オブジェクトのインスタンスを管理することになります。

注意点としては、RCW は COM オブジェクトとは別の形で参照カウントをカウントしている点になります。
そのため、既存のアンマネージ COM オブジェクトに対して接続する際においては、独自の参照カウンタのみを増やし、既存オブジェクトを再利用する動作等に至ります。

タイトル : ランタイム呼び出し可能ラッパー
アドレス : https://msdn.microsoft.com/ja-jp/library/8bwh56xe.aspx

2) Marshal.ReleaseComObject メソッド呼び出しについて

Marshal.ReleaseComObject メソッドは、New 演算子で割り当てた RCW に対して、参照カウントを減算し、オブジェクトの解放処理につなげる重要な処理です。

参照カウントが 0 になると、該当の RCW や COM オブジェクト (CLR ヒープ内に存在するマネージ COM オブジェクト) は、ガベージコレクトの対象となります。
.NET Framework は参照されている (参照カウント > 0) のオブジェクトを、解放しません。

3) Null (Nothing) 代入について

ガベージコレクトを強制する前に、null 代入をしておくことでオブジェクトの即時解放率が高まります。

.NET Framework で用意されているデバッガ拡張の SOS 等で CLR ヒープを覗いてみると、ApplicationClass クラス等の CoClass に対しても参照がされており null 代入を実施すると、!gcroot コマンド等で確認する限り、参照が 1 つ減ることが確認できます。(SOS の使用方法は、続編でも少しだけご紹介します。)

タイトル : SOS.dll (SOS デバッガー拡張)
アドレス : https://msdn.microsoft.com/ja-jp/library/bb190764.aspx

何らかの理由によってオブジェクトに対して強い参照が残っている場合は、ガベージコレクトの対象にならない場合がありますので、null 代入をすることで参照を解放でき、即時にオブジェクトの解放が実施されやすくする効果が期待できます。

!gcroot 029244f0…Scan Thread 13220 OSTHread 33a4ESP:2febdc:Root:029244f0(Microsoft.Office.Interop.Excel.ApplicationClass)ESP:2febe8:Root:029244f0(Microsoft.Office.Interop.Excel.ApplicationClass)Scan Thread 972 OSTHread 3cc

Null 代入を実施することで、赤字の参照エントリが消えることを確認しています。

TipsNull 代入の後、GC.Collect メソッドを実行するだけで良いように見える場合があります (例. EXCEL.EXE プロセスが終了するなど) が、これは非常に危険な方法です。RCW への参照を残しているままの状態では、COM オブジェクト生成や参照等を繰り返した際に、例えば開発者が解放済みと考えている COM オブジェクトに対して接続しに行くなど、正しい COM オブジェクトに対する接続が実施できる保障ができなくなります。

4) GC.Collect メソッド ( ガベージコレクト ) について

上述にて記載した通り、GC.Collect メソッドは参照が残っているオブジェクトを解放しません。

つまり、COM オブジェクトを扱う場合には、GC.Collect メソッド呼び出しにより、参照カウンタが 0 になった RCW や COM オブジェクトをファイナライズキューを移動させ、ファイナライズが動作するよう促します。
以後、ファイナライザースレッドが、他スレッドの動作を止めて、ファイナライズキュー内に移動されたオブジェクトを解放していく動作となります。

タイトル : ガベージコレクション
アドレス : https://msdn.microsoft.com/ja-jp/library/0xy59wtx.aspx

なお、ガベージコレクトを呼び出すことの必要性の根拠については、後述にてご説明します。

5) GC.WaitForPendingFinalizers メソッドについて

GC.Collect メソッドはファイナライザーを実施させるよう影響します。このメソッドは、ファイナライズ対象のオブジェクトが格納されるファイナライズキューが空になるまで待機するメソッドです。

6) 2 度目の GC.Collect メソッドについて

上記までの処理で解放されたオブジェクトが他の COM オブジェクトを参照していた場合、2 度目の GC.Collect メソッドにて、前回解放されなかった COM オブジェクトがやっとガベージコレクトの対象になります。
この際に、2 度目の GC.Collect メソッド実行時にファイナライズキューに移動し、ファイナライズ処理される動作となります。

参考情報

ここまでの投稿に関連した参考情報を記載します。

タイトル : .NET アプリケーションのパフォーマンスとスケーラビリティの向上 - 第 7 章「相互運用パフォーマンスの向上」
アドレス : https://msdn.microsoft.com/ja-jp/library/ff647812.aspx

2. オブジェクト解放漏れによる影響とは

冒頭にも触れましたが、オブジェクト解放漏れによる影響は以下が考えられます。

すでに、これまでの説明でご理解いただいた方が多いかと思いますが、オブジェクト解放に問題があると解放漏れのオブジェクトがメモリを圧迫するなどパフォーマンスへの影響が発生することは想像できるかと思います。

しかし、それ以上に .NET 上で記載したクライアントクラスが COM オブジェクトへの接続処理を誤って、様々な予期せぬ動作を引き起こす結果につながる可能性があります。
これは、意図しない COM オブジェクトに対して接続されることで、対象オブジェクトの状況に応じて異なる結果を返したり、接続不可の場合はエラーを返したり、ロックされてしまって固まったりしてしまう結果にもなり得ます。また、場合によっては、Office 内部において、オブジェクトが意図しない形で残っていることなどにより、終了時の処理でダイアログが出たりする事象も確認されております。

この予測できない現象に対する問題の根本原因を特定するまでには、多くの場合、かなりの労力が必要となることが考えられます。
そのため、オブジェクト解放については、ベストプラクティスのコードを順守して実装をご検討いただければと思います。

ガベージコレクトの強制を必要とする理由

.NET Framework では自動メモリ管理を実装しているため、オブジェクトの解放時期が予測できません。そのため、この解放待ちのオブジェクトが、アンマネージの処理において再利用されてしまう危険性もあります。

前回の投稿 Office のプロセスインスタンス制御についてでも一部ご紹介しましたが、Office アプリケーションは、オブジェクト生成等を実施した際に、ワークステーション単位で管理されているランニングオブジェクトテーブル (ROT) 等に登録していて、様々な状況下で OLE や DDE 等のテクノロジーを基盤としてオブジェクトを再利用する動作となります。

まず、上述のようなアプリケーションでブック 1 というファイルを開いている場合、上述のような構成でアプリケーションが動作することになります。
ここで、ユーザーがエクスプローラより xlsx ファイル (ブック 2) を開いたらどうなるでしょうか。

上述のようになります。つまり、.NET Framework 上でガベージコレクト待ちで解放されていないオブジェクト (ネイティブオブジェクトへの参照) であっても、OLE 側ではアプリケーションオブジェクトには変わりなく、プロセスはプロセスに変わりありません。したがって、既存のオブジェクトすなわちプロセスインスタンスが再利用されてしまう動作となります。

正しいオブジェクト解放をあきらめたカスタムアプリケーションが最後にとってしまう最悪のシナリオは、自分が起動したプロセスを Process.Kill メソッドで強制終了してしまうことです。しかし、上記の状況においてはブック 2 はユーザーが手動でファイルを開いている状態となりますので、プロセスの強制終了はユーザーデータの損傷と直結します。

また、微妙なタイミングによって、.NET Framework 上でガベージコレクトが実行されるタイミングと、ユーザーがファイルを開くタイミングが微妙に重なり、ユーザーがファイルを開いているのに反応しないという状況も実際にありました。

このような状況を防ぐため、ユーザーがカスタムアプリケーションで操作中の間にガベージコレクトをしっかり実行しておいて、他のオペレーションに影響しないように実装することが、ユーザーデータを守る上で重要と考えます。

補足

上記の記載はクライアントアプリケーションでの実装を想定してお話しております。パフォーマンスを考慮すると、Web サーバー等の処理で GC.Collect メソッドの呼び出しを実施すると、ファイナライズ処理の間は全ユーザーのページ要求処理等が待機させられますので大変危険です。

サーバーサイドオートメーションは製品としてサポート対象外であり、あくまで実施してないことを前提としてお話しております。

今回の投稿は以上となります。

なお、本編の続編では、実際にオブジェクト解放漏れを探す際のトラブルシューティング方法を少しだけご紹介します。

Office オートメーションで割り当てたオブジェクトを解放する - Part2

Additional resources