Office ソリューションの問題のトラブルシューティング

[アーティクル]
03/21/2023

適用対象: Visual Studio

この記事では、Visual Studio で Office ソリューションを開発しているときにさまざまなタスクを実行するときに発生する可能性がある問題のトラブルシューティング方法について説明します。

プロジェクトを作成、アップグレード、および開くときの問題

Office プロジェクトを作成または開くときに、次の問題が発生する可能性があります。

問題 1: プロジェクトを作成できない

Office プロジェクトを作成または開こうとしたときにエラーが発生したが、Visual Studio に原因を特定するのに十分な情報がない場合は、プロジェクトを閉じて Visual Studio を終了し、もう一度開始してください。

ドキュメントレベルのプロジェクトを作成しようとしている場合は、新しいプロジェクトのドキュメントと同じ名前の別のドキュメントが Excel またはWordで既に開いている可能性があります。 Excel またはWordの他のすべてのインスタンスが閉じられていることを確認します。

問題 2: 既存のプロジェクトのドキュメントに基づいて新しいプロジェクトを作成すると、コントロールプロパティが失われます

既存のプロジェクトのドキュメントに基づいて新しい Office プロジェクトを作成した場合、ドキュメント上にあるコントロールのプロパティは新しいプロジェクトにコピーされません。既存のコントロールのプロパティを手動でリセットします。または、新しいプロジェクトを作成するのではなく、既存のプロジェクトのコピーを作成するか、(デザイナーで) 新しいソリューションに既存のプロジェクトを読み込み、既存のドキュメントから新しいドキュメントにコントロールをコピーして貼り付けることで、コントロールプロパティを保持することもできます。

問題 3: 既存のブックに基づいて Excel ブックプロジェクトを作成するときのエラー

既存のブックに基づいて新しい Excel ブックプロジェクトを作成すると、次のエラーの組み合わせが表示されることがあります。

Excel から: "プライバシー警告: このドキュメントには、マクロ、ActiveX コントロール、XML 拡張パック情報、または Web コンポーネントが含まれています。これには、ドキュメント検査官が削除できない個人情報が含まれる場合があります。
Visual Studio から: "Designerが正しく読み込めませんでした。

これらのエラーは、ドキュメントインスペクターを使用して個人情報が削除されたブックに基づくプロジェクトを作成しようとするときに発生する可能性があります。この問題を回避するには、プロジェクトを作成する前に次の手順を実行します。

Excel でブックを開きます。
Excel で、セキュリティセンターを開きます。
[プライバシーオプション] タブで、[チェック保存時にファイルのプロパティから個人情報を削除する] ボックスをオフにします。
ブックを保存し、Excel を閉じます。

問題 4: 移行後にプロジェクトを開くことができない

Office ソリューションを Microsoft Office 2010 に移行した後、2007 Microsoft Office システムのみがインストールされている開発用コンピューターでプロジェクトを開くできません。次のエラーが表示される場合があります。

"ソリューション内の 1 つ以上のプロジェクトが正しく読み込まれていませんでした。詳細については、出力ウィンドウを参照してください。
"このプロジェクトの種類に関連付けられているアプリケーションがこのコンピューターにインストールされていないため、プロジェクトを作成できません。このプロジェクトの種類に関連付けられている Microsoft Office アプリケーションをインストールする必要があります。

この問題を解決するには、 .vbproj または .csproj ファイルを 編集します。 Word プロジェクトの場合は、をにHostPackage="{6CE98B71-D55A-4305-87A8-0D6E368D9600}"置き換えますHostPackage="{763FDC83-64E5-4651-AC9B-28C4FEB985A1}"。 Excel プロジェクトの場合は、をにHostPackage="{825100CF-0BA7-47EA-A084-DCF3308DAF74}"置き換えますHostPackage="{B284B16A-C42C-4438-BDCD-B72F4AC43CFB}"。 Outlook プロジェクトの場合は、をにHostPackage="{20A848B8-E01F-4801-962E-25DB0FF57389}"置き換えますHostPackage="{D2B20FF5-A6E5-47E1-90E8-463C6860CB05}"。

または、移行されたプロジェクトが、Microsoft Office 2010 が既にインストールされている開発用コンピューターでのみ開くようにします。

問題 5: Windows フォームコントロールを含むアップグレードされた Office 2003 ドキュメントレベルプロジェクトのエラー

Microsoft Office 2003 ドキュメントレベルのプロジェクトをアップグレードし、ドキュメントにWindows フォームコントロールが含まれている場合、アップグレードされたプロジェクトにコンパイルエラーまたは実行時エラーが発生する可能性があります。この問題を回避するには、プロジェクトをアップグレードする前に、開発用コンピューターに Visual Studio 2005 Tools for Office Second Edition Runtime をインストールします。このバージョンのランタイムは、Microsoft Visual Studio 2005 Tools for Office Second Edition Runtime (VSTO 2005 SE) (x86) の Microsoft ダウンロードセンターから再頒布可能パッケージとして利用できます。

プロジェクトのアップグレードが完了したら、Visual Studio 2005 Tools for Office Second Edition Runtime を開発用コンピューターからアンインストールできます (他の Office ソリューションで使用されていない場合)。

デザイナーを使用するときの問題

ドキュメントレベルのプロジェクトでドキュメント、ブック、またはワークシートデザイナーを操作すると、次の問題が発生する可能性があります。

問題 1: Designerが正しく読み込めませんでした

次の場合、Visual Studio でデザイナーを開くできません。

Excel またはWordは既に開いているので、モーダルダイアログボックスが表示されています。デザイナーを開くには、チェックして、Excel またはWordにモーダルダイアログボックスが開いているかどうかを確認し、開いているモーダルダイアログボックスを閉じます。開いているモーダルダイアログボックスがない場合は、Excel または Word が応答する前に、他の操作が必要な場合があります。
プロジェクトは現在デバッグ中です。デザイナーを開くには、デバッグを停止または終了します。
開発用コンピューターにインストールされている Excel VSTO アドインが、Excel の起動時にダイアログボックスを表示しています。 Excel ドキュメントレベルのプロジェクトを作成するには、まず VSTO アドインを無効にする必要があります。

問題 2: コントロールがドキュメントまたはワークシートに黒い四角形として表示される

ドキュメントまたはワークシートでコントロールをグループ化した場合、Visual Studio はコントロールを認識しなくなります。グループ化されたコントロールは、[ プロパティ ] ウィンドウではアクセスできません。また、ドキュメントまたはワークシートに黒い四角形として表示されます。コントロールの機能を復元するには、コントロールのグループ化を解除する必要があります。

問題 3: Word テンプレートのコントロールが Visual Studio に表示されない

Visual Studio デザイナーでWord テンプレートを開いた場合、テキストに一直線に並んでいないテンプレートのコントロールが表示されない可能性があります。これは、Visual Studio で標準ビュー Wordテンプレートが開かれるためです。コントロールを表示するには、[表示] メニューを選択し、[Microsoft Office Word表示] をポイントし、[印刷レイアウト] を選択します。

問題 4: クリップアートの挿入コマンドが Visual Studio デザイナーで何も実行しない

Visual Studio デザイナーで Excel またはWordを開いている場合、リボンの [図] タブの [クリップアート] ボタンをクリックしても、[クリップアート] 作業ウィンドウは開きません。クリップアートを追加するには、Visual Studio の外部にあるメインプロジェクトフォルダー (\bin フォルダー内のコピーではない) にあるブックまたはドキュメントのコピーを開き、クリップアートを追加してブックまたはドキュメントを保存する必要があります。

コードを記述するときの問題

Office プロジェクトでコードを記述するときに、次の問題が発生する可能性があります。

問題 1: C を使用しているときに Office オブジェクトの一部のイベントにアクセスできない#

場合によっては、Visual C# プロジェクトの Office プライマリ相互運用機能アセンブリ (PIA) 型のインスタンスの特定のイベントにアクセスしようとすると、次のようなコンパイラエラーが発生することがあります。

'Microsoft.Office.Interop.Excel._Application.NewWorkbook' と 'Microsoft.Office.Interop.Excel.AppEvents_Event.NewWorkbook' の間のあいまいさ

このエラーは、オブジェクトの別のプロパティまたはメソッドと同じ名前のイベントにアクセスしようとしていることを意味します。イベントにアクセスするには、オブジェクトを そのイベントインターフェイスにキャストする必要があります。

イベントを持つ Office PIA 型では、すべてのプロパティとメソッドを含むコアインターフェイスと、オブジェクトによって公開されるイベントを含むイベントインターフェイスという 2 つのインターフェイスが実装されています。これらのイベントインターフェイスでは、や ApplicationEvents2_EventなどのAppEvents_Event名前付け規則 _<objectname>Events<n>Event が使用されます。オブジェクトで見つかると思われるイベントにアクセスできない場合は、オブジェクトをそのイベントインターフェイスにキャストします。

たとえば、 Application オブジェクトには NewWorkbook イベントとプロパティがあります NewWorkbook 。イベントを NewWorkbook 処理するには、を Application インターフェイスに AppEvents_Event キャストします。次のコード例は、Excel のドキュメントレベルのプロジェクトでこれを行う方法を示しています。

private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    ((Excel.AppEvents_Event)this.Application).NewWorkbook += 
        new Excel.AppEvents_NewWorkbookEventHandler(ThisWorkbook_NewWorkbook);
}

void ThisWorkbook_NewWorkbook(Excel.Workbook Wb)
{
    // Perform some work here.
}

Office PIA のイベントインターフェイスの詳細については、「Office プライマリ相互運用機能アセンブリのクラスとインターフェイスの概要」を参照してください。

問題 2: .NET Framework 4 または .NET Framework 4.5 を対象とするプロジェクトで Office PIA クラスを参照できない

.NET Framework 4 または .NET Framework 4.5 を対象とするプロジェクトでは、Office PIA で定義されているクラスを参照するコードは既定ではコンパイルされません。 PIA のクラスでは、や WorkbookClassなどのDocumentClass名前付け規則 <objectname>クラスが使用されます。たとえば、Word VSTO アドインプロジェクトの次のコードはコンパイルされません。

Word.DocumentClass document = (Word.DocumentClass) Globals.ThisAddIn.Application.ActiveDocument;

Dim document As Word.DocumentClass = Globals.ThisAddIn.Application.ActiveDocument

このコードでは、次のコンパイルエラーが発生します。

Visual Basic: "アセンブリが No-PIA モードを使用してリンクされている場合、クラス 'DocumentClass' への参照は許可されません。
Visual C#: "相互運用タイプ 'Microsoft.Office.Interop。Word。DocumentClass' を埋め込むことができません。代わりに該当するインターフェイスを使用してください。

このエラーを解決するには、代わりに対応するインターフェイスを参照するようにコードを変更します。たとえば、オブジェクトを DocumentClass 参照するのではなく、代わりにインターフェイスのインスタンスを Document 参照します。

Word.Document document = Globals.ThisAddIn.Application.ActiveDocument;

Dim document As Word.Document = Globals.ThisAddIn.Application.ActiveDocument

.NET Framework 4 または .NET Framework 4.5 を対象とするプロジェクトでは、既定ですべての相互運用機能の種類が Office PIA から自動的に埋め込まれます。このコンパイルエラーは、埋め込み相互運用機能はクラスではなくインターフェイスでのみ機能するため発生します。 Office PIA のインターフェイスとクラスの詳細については、「Office プライマリ相互運用機能アセンブリのクラスとインターフェイスの概要」を参照してください。 Office プロジェクトの埋め込み相互運用機能の詳細については、「Office ソリューションの設計と作成」を参照してください。

問題 3: Office クラスへの参照が認識されない

Application などの一部のクラス名は、や System.Windows.FormsなどのMicrosoft.Office.Interop.Word複数の名前空間にあります。このため、プロジェクトテンプレートの上部にある Imports/using ステートメントには、次のような短縮形の修飾定数が含まれています。

using Word = Microsoft.Office.Interop.Word;

Imports Word = Microsoft.Office.Interop.Word

Imports/ using ステートメントを使用するには、次のように、Wordまたは Excel 修飾子を使用して Office クラスへの参照を区別する必要があります。

Word.Document doc;

Dim doc As Word.Document

修飾されていない宣言を使用すると、次のようなエラーが発生します。

Document doc;  // Class is ambiguous

Dim doc As Document  ' Class is ambiguous

Wordまたは Excel 名前空間をインポートし、その中のすべてのクラスにアクセスできる場合でも、名前空間のあいまいさを削除するには、Wordまたは Excel ですべての型を完全に修飾する必要があります。

プロジェクトをビルドするときの問題

Office プロジェクトをビルドするときに、次の問題が発生する可能性があります。

問題 1: アクセス許可が制限されたドキュメントに基づくドキュメントレベルのプロジェクトをビルドできない

ドキュメントにアクセス許可が制限されている場合、Visual Studio はドキュメントレベルのプロジェクトをビルドできません。プロジェクトにアクセス許可が制限されたドキュメントが含まれている場合、プロジェクトはコンパイルされないため、[ エラー一覧 ] ウィンドウに次のメッセージが表示されます。

カスタマイズを追加できませんでした。

アクセス許可が制限されているドキュメントを含める場合は、ソリューションの開発とビルド中に無制限のドキュメントを使用します。次に、ソリューションを発行した後、発行場所のドキュメントに制限付きアクセス許可を適用します。

問題 2: NamedRange コントロールが削除された後にコンパイラエラーが発生する

デザイナーで NamedRange アクティブなワークシートではないワークシートからコントロールを削除すると、自動生成されたコードがプロジェクトから削除されず、コンパイラエラーが発生する可能性があります。コードが確実に削除されるようにするには、コントロールを削除する前に、コントロールを含む NamedRange ワークシートを常に選択してアクティブワークシートにする必要があります。コントロールを削除するときに自動生成されたコードが削除されない場合は、ワークシートをアクティブ化し、ワークシートが変更済みとしてマークされるように変更を行うことで、デザイナーにコードを削除させることができます。プロジェクトをリビルドすると、コードが削除されます。

プロジェクトをデバッグするときの問題

Office プロジェクトをデバッグするときに、次の問題が発生する可能性があります。

問題 1: 開発用コンピューターにソリューションを発行してインストールすると、アンインストールを求めるメッセージが表示される

Office ソリューションをデバッグすると、次のエラーが表示されることがあります。

別のバージョンが現在インストールされており、この場所からアップグレードできないため、カスタマイズをインストールできません。

このエラーは、以前に開発用コンピューターに Office ソリューションを発行してインストールしたことを示します。メッセージが表示されないようにするには、ソリューションをデバッグする前に、コンピューターにインストールされているプログラムの一覧からソリューションをアンインストールします。または、開発用コンピューターに別のユーザーアカウントを作成して、発行されたソリューションのインストールをテストすることもできます。

問題 2: UNC ネットワークの場所で作成されたドキュメントレベルのプロジェクトが Visual Studio から実行されない

Excel 用のドキュメントレベルのプロジェクトを作成するか、UNC ネットワークの場所でWordする場合は、ドキュメントの場所を Excel またはWordの信頼できる場所の一覧に追加する必要があります。そうしないと、Visual Studio でプロジェクトを実行またはデバッグしようとすると、カスタマイズは読み込まれません。信頼できる場所の詳細については、「ドキュメントに信頼を付与する」を参照してください。

問題 3: デバッグ後にスレッドが正しく停止しない

Visual Studio の Office プロジェクトは、デバッガーがプログラムを正しく閉じできるようにするためのスレッドの名前付け規則に従います。ソリューションでスレッドを作成する場合は、デバッグを停止したときにこれらのスレッドが正しく処理されるように、各スレッドにプレフィックス VSTA_を付ける必要があります。たとえば、ネットワークイベントのNameVSTA_NetworkListenerを待機するスレッドのプロパティを設定できます。

問題 4: 開発用コンピューターで Office ソリューションを実行またはデバッグできない

開発用コンピューターで Office プロジェクトを実行または開発できない場合は、次のエラーメッセージが表示されることがあります。

アプリケーションドメインを作成できなかったため、カスタマイズを読み込めませんでした。

Visual Studio では、.NET Framework アセンブリローダーである Fusion を使用して、Office ソリューションを読み込む前にアセンブリをキャッシュします。 Visual Studio が Fusion キャッシュに書き込みできることを確認し、もう一度やり直してください。詳細については、「シャドウコピーアセンブリ」を参照してください。

問題 5: 編集と続行を使用した後、ドキュメントレベルのプロジェクトでデバッガーを停止するとエラーが発生する

プロジェクトが中断モードの間に Excel またはWordのドキュメントレベルのプロジェクトのコードを編集して続行を使用して変更を加えた場合、デバッガーを停止すると、次のエラーメッセージが表示されるダイアログボックスが表示されることがあります。

プロセスを現在の状態で終了すると、データの損失やシステムの不安定性など、望ましくない結果が発生する可能性があります。

ダイアログボックスで [はい] または [いいえ] を選択した場合でも、Visual Studio は Excel または Word プロセスを終了し、デバッガーを停止します。このダイアログボックスを表示せずにプロジェクトのデバッグを停止するには、Visual Studio でデバッガーを停止するのではなく、Excel またはWordを直接終了します。

次の方法で共有

Office ソリューションの問題のトラブルシューティング

プロジェクトを作成、アップグレード、および開くときの問題

問題 1: プロジェクトを作成できない

問題 2: 既存のプロジェクトのドキュメントに基づいて新しいプロジェクトを作成すると、コントロールプロパティが失われます

問題 3: 既存のブックに基づいて Excel ブックプロジェクトを作成するときのエラー

問題 4: 移行後にプロジェクトを開くことができない

問題 5: Windows フォームコントロールを含むアップグレードされた Office 2003 ドキュメントレベルプロジェクトのエラー

デザイナーを使用するときの問題

問題 1: Designerが正しく読み込めませんでした

問題 2: コントロールがドキュメントまたはワークシートに黒い四角形として表示される

問題 3: Word テンプレートのコントロールが Visual Studio に表示されない

問題 4: クリップアートの挿入コマンドが Visual Studio デザイナーで何も実行しない

コードを記述するときの問題

問題 1: C を使用しているときに Office オブジェクトの一部のイベントにアクセスできない#

問題 2: .NET Framework 4 または .NET Framework 4.5 を対象とするプロジェクトで Office PIA クラスを参照できない

問題 3: Office クラスへの参照が認識されない

プロジェクトをビルドするときの問題

問題 1: アクセス許可が制限されたドキュメントに基づくドキュメントレベルのプロジェクトをビルドできない

問題 2: NamedRange コントロールが削除された後にコンパイラエラーが発生する

プロジェクトをデバッグするときの問題

問題 1: 開発用コンピューターにソリューションを発行してインストールすると、アンインストールを求めるメッセージが表示される

問題 2: UNC ネットワークの場所で作成されたドキュメントレベルのプロジェクトが Visual Studio から実行されない

問題 3: デバッグ後にスレッドが正しく停止しない

問題 4: 開発用コンピューターで Office ソリューションを実行またはデバッグできない

問題 5: 編集と続行を使用した後、ドキュメントレベルのプロジェクトでデバッガーを停止するとエラーが発生する

関連情報

フィードバック

フィードバック

その他のリソース

次の方法で共有

Office ソリューションの問題のトラブルシューティング

プロジェクトを作成、アップグレード、および開くときの問題

問題 1: プロジェクトを作成できない

問題 2: 既存のプロジェクトのドキュメントに基づいて新しいプロジェクトを作成すると、コントロール プロパティが失われます

問題 3: 既存のブックに基づいて Excel ブック プロジェクトを作成するときのエラー

問題 4: 移行後にプロジェクトを開くことができない

問題 5: Windows フォーム コントロールを含むアップグレードされた Office 2003 ドキュメント レベルプロジェクトのエラー

デザイナーを使用するときの問題

問題 1: Designerが正しく読み込めませんでした

問題 2: コントロールがドキュメントまたはワークシートに黒い四角形として表示される

問題 3: Word テンプレートのコントロールが Visual Studio に表示されない

問題 4: クリップ アートの挿入コマンドが Visual Studio デザイナーで何も実行しない

コードを記述するときの問題

問題 1: C を使用しているときに Office オブジェクトの一部のイベントにアクセスできない#

問題 2: .NET Framework 4 または .NET Framework 4.5 を対象とするプロジェクトで Office PIA クラスを参照できない

問題 3: Office クラスへの参照が認識されない

プロジェクトをビルドするときの問題

問題 1: アクセス許可が制限されたドキュメントに基づくドキュメント レベルのプロジェクトをビルドできない

問題 2: NamedRange コントロールが削除された後にコンパイラ エラーが発生する

プロジェクトをデバッグするときの問題

問題 1: 開発用コンピューターにソリューションを発行してインストールすると、アンインストールを求めるメッセージが表示される

問題 2: UNC ネットワークの場所で作成されたドキュメント レベルのプロジェクトが Visual Studio から実行されない

問題 3: デバッグ後にスレッドが正しく停止しない

問題 4: 開発用コンピューターで Office ソリューションを実行またはデバッグできない

問題 5: 編集と続行を使用した後、ドキュメント レベルのプロジェクトでデバッガーを停止するとエラーが発生する

関連情報

フィードバック

フィードバック

その他のリソース

問題 2: 既存のプロジェクトのドキュメントに基づいて新しいプロジェクトを作成すると、コントロールプロパティが失われます

問題 3: 既存のブックに基づいて Excel ブックプロジェクトを作成するときのエラー

問題 5: Windows フォームコントロールを含むアップグレードされた Office 2003 ドキュメントレベルプロジェクトのエラー

問題 4: クリップアートの挿入コマンドが Visual Studio デザイナーで何も実行しない

問題 1: アクセス許可が制限されたドキュメントに基づくドキュメントレベルのプロジェクトをビルドできない

問題 2: NamedRange コントロールが削除された後にコンパイラエラーが発生する

問題 2: UNC ネットワークの場所で作成されたドキュメントレベルのプロジェクトが Visual Studio から実行されない

問題 5: 編集と続行を使用した後、ドキュメントレベルのプロジェクトでデバッガーを停止するとエラーが発生する