ドキュメント レベルのプロジェクトのデバッグ
更新 : 2010 年 9 月
Microsoft Office Word および Microsoft Office Excel 用のドキュメント レベルのプロジェクトのデバッグには、他のプロジェクトの場合と同じ Visual Studio ツールを使用できます。 デバッグ モードでプロジェクトを実行すると、Visual Studio で Word または Excel が起動し、Word または Excel と同じプロセスで実行されるすべての要素にデバッガーがアタッチされます。 Visual Studio のデバッグ ツールの詳細については、「Visual Studio でのデバッグ」を参照してください。
ヒント
ビルドおよびデバッグを実行する前に、Word または Excel の開いているインスタンスを閉じて競合を回避してください。
対象: このトピックの情報は、Excel 2007 と Excel 2010、および Word 2007 と Word 2010 のドキュメント レベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクト タイプ別の使用可能な機能」を参照してください。
.gif "ビデオへのリンク")
関連のビデオ デモについては、「How Do I: Debug a VSTO Application? (操作方法: VSTO アプリケーションをデバッグする)」を参照してください。
F10 および F11 キーの動作
Office プロジェクトのデバッグ開始における F10 および F11 キーの動作は、他の Visual Basic または C# プロジェクトのデバッグ開始の場合と同じではありません。 Visual Basic や C# のプロジェクトの場合、デバッガーはメイン関数で停止しますが、Office プロジェクトの場合、Visual Studio では Office アプリケーションのメイン関数に対する制御権がありません。 ただし、デバッグ実行中の F10 および F11 キーの機能は、Visual Basic および C# のプロジェクトの場合と同じです。 詳細については、「Debugging Shortcut Keys, Brief Scheme」を参照してください。
デバッガーの停止
文書またはブックのデバッグを開始すると、文書またはブックは新しい Word または Excel プロセスで開かれます。 デバッガーを停止すると、Word または Excel プロセスが即座に停止されます。また、デバッガーをデタッチするように設定してある場合にはデバッガーがデタッチされます。 次に停止する Word または Excel プロセスで開かれている他のすべての文書またはブックも、警告を表示せずに閉じ、保存されていない変更内容は失われます。 これには、デバッガーの実行中に開かれた文書やブックもすべて含まれます。
一般に、通常の方法で Word や Excel を終了できるように、デバッガーを停止する前にプロセスからデタッチしておくことをお勧めします。 デバッガーを停止した後も開いている文書やワークシートを操作する場合は、プロセスからデタッチすることもできます。 プロセスからのデタッチの詳細については、「方法 : すべてのプロセスをデタッチする」を参照してください。
負荷の大きいデバッグのセッション実行中に、デバッガーが何度も停止したり Word が突然終了したりすると、Normal テンプレートが壊れる場合があります。 その場合は壊れた Normal テンプレートを削除します。テンプレートは、Word を次に開いたときに自動的に再作成されます。 ただし、Normal テンプレートに格納されていたマクロは再作成されません。
Visual Studio での作業時の Word による Normal テンプレートのロック
Visual Studio で Word を開くと、既定の Normal テンプレートがロックされます。 デバッグのためにソリューションを実行する場合、Word のコピーが別のプロセスで開かれます。 開かれている Word のコピーに対してアプリケーション レベルのカスタマイズを行っても、Visual Studio 内で開かれているプロセスによって Normal テンプレートがロックされているので変更は保存されません。
実行時に、Word は 1 つのプロセスで複数の文書のインスタンスを個別に開きます。したがって、開かれている 1 つの文書によって Normal テンプレートがロックされ、アプリケーション レベルの変更が妨げられる可能性は高くありません。
詳細については、サポート技術情報の文書「オートメーション サーバーとして Word を使用する場合、 Normal.dot を変更することを確認します。 (https://support.microsoft.com/default.aspx?scid=kb;ja-jp;285885)」を参照してください。
キャッシュされたデータセットのデバッグ
プロジェクトをビルドするたびに、データセットは空になり、再作成されます。 キャッシュされたデータセットをデバッグする場合は、Visual Studio の外部で文書を開いてからデバッガーをアタッチする必要があります。
Word 97 ～ Word 2003 の文書 (*.doc) 形式に基づく Word 文書プロジェクトのデバッグ
Word 97 ～ Word 2003 の文書 (*.doc) 形式に基づく Word 文書プロジェクトをデバッグするには、信頼できるフォルダー一覧にプロジェクト フォルダーを追加する必要があります。 この手順の詳細については、「ドキュメントへの信頼の付与」を参照してください。
ソース管理
デバッグ プロパティは、ソース管理で複数のユーザー間では共有されません。 Visual Basic プロジェクトや Visual C# プロジェクトでは、デバッグ プロパティはユーザー固有のファイル (<ProjectName>.vbproj.user または <ProjectName>.csproj.user) に格納されます。このファイルはソース管理で管理されません。 複数のユーザーがデバッグを実行する場合は、各自が手動でデバッグ プロパティを入力する必要があります。
コマンド ライン引数
[デバッグ] プロパティ ページの [開始動作] が [スタート プロジェクト] に設定されている場合、Visual Studio ではプロジェクトのデバッグ時にコマンド ライン引数を使用しません。起動オプションでコマンド ライン引数を指定した場合でも同様です。 デバッグの開始時にコマンド ライン引数を使用するには、[開始動作] を [スタート プロジェクト] 以外に設定する必要があります。
イベント ビューアーを使用したインストールのエラーのトラブルシューティング
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% フォルダーに作成されます。 ログ ファイルの名前は、<ドキュメント名>.<拡張子>.log です (例: ExcelWorkbook1.xlsx.log)。 エラーのログ記録を停止するには、この環境変数を 0 (ゼロ) に設定します。
参照
処理手順
概念
その他の技術情報
履歴の変更
日付 |
履歴 |
理由 |
|---|---|---|
|
2010 年 9 月 |
イベント ビューアーを使用したインストールのエラーのトラブルシューティングに関するセクションを追加しました。 |
情報の拡充 |
|
2010 年 5 月 |
エラーのログ記録に関する詳細情報を一部修正しました。 |
コンテンツ バグ修正 |