アプリケーション レベルのプロジェクトのデバッグ

更新 : 2010 年 9 月

アプリケーション レベルのプロジェクトのデバッグは、他の Visual Studio プロジェクトに使用するのと同じ Microsoft Visual Studio ツールを使用して実行できます。 アプリケーション レベルのプロジェクトのデバッグ時には、ブレークポイントの挿入や [ローカル] ウィンドウでの変数の表示など、Visual Studio デバッガーの機能も使用できます。 Visual Studio のデバッグ ツールの詳細については、「Visual Studio でのデバッグ」を参照してください。 アプリケーション レベルのプロジェクトの詳細については、「アプリケーション レベルのアドインのアーキテクチャ」を参照してください。

対象: このトピックの情報は、Microsoft Office 2010 および 2007 Microsoft Office system のアプリケーション レベルのプロジェクトに適用されます。 詳細については、「Office アプリケーションおよびプロジェクト タイプ別の使用可能な機能」を参照してください。

関連のビデオ デモについては、「How Do I: Debug a VSTO Application? (操作方法: VSTO アプリケーションをデバッグする)」を参照してください。

デバッガーの起動と停止

アプリケーション レベルのプロジェクトのデバッグの開始方法は、他の Visual Studio プロジェクトのデバッグの開始方法と同じです (F5 キーを押すなど)。 プロジェクトのデバッグを開始すると、対象 Office アプリケーションの新しいプロセスが開始され、アドインが読み込まれます。 デバッガーを停止すると、アプリケーション プロセスが即座に停止されます。また、デバッガーをデタッチするように設定してある場合にはデバッガーがデタッチされます。 詳細については、「Debugging Shortcut Keys, Brief Scheme」を参照してください。

例外の表示

Visual Studio の Office 開発ツールで作成されたアドインが例外をスローした場合、Microsoft Office アプリケーションはその例外を表示せずに動作を継続します。 アドインの例外がスローされたときにそのことを確認するには、例外がスローされるたびに中断するようデバッガーを設定します。 詳細については、「方法 : Office プロジェクトのエラーを処理する」を参照してください。

例外をスローする可能性のあるコードの近くに Try...Catch ステートメントを挿入することもできます。 Try...Catch ステートメントを使用する方法の詳細については、「方法: Try...Catch ブロックを使用してコードを検査する (Visual Basic)」および「方法: try/catch を使用して例外を処理する (C# プログラミング ガイド)」を参照してください。

無効化されたアドインのデバッグ

Microsoft Office アプリケーションでは、予期しない動作を行うアドインを無効にする場合があります。 Microsoft Office アプリケーションは、起動するたびに問題のあるコードが読み込まれないようにするため、アドインを無効にします。 しかし、通常のデバッグ時に、予期しない動作が発生することはよくあります。 アドインを再び有効にする方法の詳細については、「方法 : 無効にされたアドインを再度有効にする」を参照してください。

Microsoft Office アプリケーションでアドインに適用される無効化には、ハードな無効化とソフトな無効化の 2 種類があります。

ハードな無効化

ハードな無効化は、アドインによってアプリケーションが予期せずに終了した場合に発生する可能性があります。 また、開発用コンピューターでアドインの Startup イベント ハンドラーの実行中にデバッガーを停止した場合にも発生することがあります。 アドインがハードに無効化されると、そのアドインがアプリケーションの [使用できないアイテム] ボックスの一覧に表示されます。

Office アプリケーションが Visual Studio の Office 開発ツールを使用して作成されたアドインをハードに無効化する場合、このアプリケーションは、エラーの原因となったアドインのみを無効化します。 Visual Studio の Office 開発ツールを使用してその Office アプリケーション用に作成されたその他のアドインの読み込みは続行されます。

ソフトな無効化

ソフトな無効化は、アドインによってエラーが発生したが、アプリケーションが予期せずに終了しなかった場合に発生する可能性があります。 たとえば、Startup イベント ハンドラーの実行中にアドインによってハンドルされない例外がスローされた場合に、アプリケーションによってそのアドインがソフトに無効化されることがあります。 アドインがソフトに無効化されると、そのアドインがアプリケーションの [アクティブでないアプリケーション アドイン] ボックスの一覧に表示され、アンロードされていないことを示すために、そのアドインの LoadBehavior レジストリ エントリの値が変更されます。 LoadBehavior レジストリ エントリの詳細については、「アプリケーション レベルのアドインのレジストリ エントリ」を参照してください。

イベント ビューアーを使用したインストールのエラーのトラブルシューティング

Office ソリューションのインストール時またはアンインストール時にスローされたすべての例外のメッセージは、Visual Studio Tools for Office Runtime によって Windows のイベント ビューアーに書き込まれます。 これらのメッセージを使用して、インストールと配置の問題を解決できます。 詳細については、「Office ソリューションのイベント ログ」を参照してください。

ログ ファイルおよびエラー メッセージを使用したスタートアップのエラーのトラブルシューティング

Visual Studio Tools for Office Runtime では、起動時に発生するすべてのエラーをログ ファイルに書き込んだり、エラーが発生するたびにメッセージ ボックスに表示したりできます。 既定では、これらのオプションはオフになっています。 オプションを有効にするには、環境変数を作成します。

エラーが発生するたびにメッセージ ボックスに表示するには、VSTO_SUPPRESSDISPLAYALERTS という環境変数を作成し、0 (ゼロ) に設定します。 メッセージが表示されないようにするには、環境変数を削除するか、1 に設定します。

エラーをログ ファイルに書き込むには、VSTO_LOGALERTS という環境変数を作成し、1 に設定します。 Visual Studio Tools for Office Runtime によって、アドインの配置マニフェストを含むフォルダーにログ ファイルが作成されます。作成できない場合は、ローカルの %TEMP% フォルダーに作成されます。 既定の名前は <アドイン名>.vsto.log です。 エラーのログ記録を停止するには、この環境変数を 0 (ゼロ) に設定します。

参照

処理手順

方法 : 無効にされたアドインを再度有効にする

方法 : Office プロジェクトのエラーを処理する

概念

アプリケーション レベルのアドインのプログラミング

その他の技術情報

Office ソリューションのビルドとデバッグ

履歴の変更