Office ソリューション配置のトラブルシューティング
このトピックでは、に関する情報を、Office ソリューションを配置するときに発生する可能性がある一般的な問題を解決する含まれています。
対象: このトピックの情報は、Office 2013 および Office 2010 のドキュメント レベルのプロジェクトおよびアプリケーション レベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクト タイプ別の使用可能な機能」を参照してください。
イベント ビューアーを使用した Office ソリューションのトラブルシューティング
Windows のイベント ビューアーを使用すると、Office ソリューションのインストール時またはアンインストール時に Visual Studio Tools for Office Runtime でキャプチャされるエラー メッセージを表示できます。イベント ロガーからのこれらのメッセージを使用して、インストールと配置の問題を解決できます。詳細については、「Office ソリューションのイベント ログ」を参照してください。
アセンブリ名の変更は競合発生の原因となる
ソリューションを配置した後 [プロジェクト デザイナー] の [アプリケーション] のページの [アセンブリ名] の値を変更すると、発行ツールは、1 種類の Setup.exe ファイル、および 2 配置マニフェストを持つようにセットアップ パッケージを変更します。2 種類のマニフェストを配置する場合は、次の条件が発生する可能性があります:
エンド ユーザーが両方のバージョンをインストールすると、アプリケーションは両方のアドインを読み込みます。
アドインがインストールされている状態でアセンブリの名前を変更すると、エンド ユーザーが更新を受け取ることはなくなります。
ソリューションを配置した後にこのような状況を回避するには、ソリューションの [アセンブリ名] の値を変更しないでください。
更新プログラムのチェックに長い時間がかかる
Office ランタイムの Visual Studio 2010 Tools は、マニフェストやソリューションをダウンロードするためのタイムアウト値を設定するには、管理者が使用できるレジストリ エントリが用意されています。
タイムアウト値を設定するには
レジストリで、次のキーに移動します。
HKEY_CURRENT_USER\Software\Microsoft\VSTA
AddInTimeout サブキーに、タイムアウト値をミリ秒単位で設定します。
[AddInTimeout] のサブキーが存在しない場合は、DWORD として作成します。
ネットワーク ファイル共有にを更新または発行できません
ネットワーク ファイル共有にある Office ソリューションは、更新の発行プロセスでソリューションの Setup.exe ファイルがロックされると、誤解を招くメッセージを表示することがあります。たとえば、"'setup.exe' を Web サイトに追加できません。ファイル 'setup.exe' はこの Web サイトに既に存在します。" というメッセージが表示されることがあります。
ファイルがロックされないようにするには、エンド ユーザーに対して共有を読み取り専用に設定します。ただし、共有上にドキュメントがあると、このドキュメントもエンド ユーザーに対して読み取り専用になります。
Microsoft Office の必須コンポーネントがインストール
.NET Framework、Visual Studio Tools for Office Runtimeを追加し、のセットアップに Office プライマリ相互運用機能アセンブリは、Office ソリューションとともに配置される必須コンポーネントとしてパッケージ化します。プライマリ相互運用機能アセンブリをインストールする方法の詳細については、「Office ソリューションを開発できるようにコンピューターを構成する」および「方法 : Office のプライマリ相互運用機能アセンブリをインストールする」を参照してください。
"Localhost" を使用して発行するとインストール問題が生じることがある
ドキュメント レベルのソリューションの発行場所またはインストール場所として "" https://localhost を使用すると、[発行ウィザード] は、実際のコンピューター名に文字列を変換しません。この場合、ソリューションは、開発用コンピューターにインストールする必要があります。配置ソリューションに開発用コンピューター上の IIS を使用させるには、HTTP、HTTPS、FTP のすべての場所について、localhost ではなく完全修飾名を使用します。
更新済みのアセンブリではなくキャッシュしたアセンブリが読み込まれる
プロジェクトの出力パスがネットワーク ファイル共有にある場合は、Fusion の .NET Framework アセンブリ ローダーは、厳密な名前は、アセンブリのキャッシュ コピーを、アセンブリ署名されていて、カスタマイズ アセンブリのバージョンは変更されません。これらの要件を満たすアセンブリを更新する場合、更新はキャッシュしたコピーが読み込まれるため、プロジェクトを実行すると、次に表示されません。
Visual Studio を構成し、プロジェクトを実行するたびに fusion がアセンブリをダウンロードするように設定できます。
キャッシュしたコピーではなくアセンブリをダウンロードするには
メニュー バーで、プロジェクト、[プロジェクト名][プロパティ] を選択します。
[アプリケーション] のページで、[アセンブリ情報] を選択します。
[アセンブリ バージョン] 最初のボックスに、アスタリスク (*) を入力し、を [OK] のボタンをクリックします。
アセンブリのバージョンを変更したら、厳密な名前でアセンブリに署名し続けることができます。Fusion は最新バージョンのカスタマイズを読み込みます。
インストールは URI に文字がその Are't、US-ASCII で失敗します。
HTTP の位置に Office ソリューションを発行すると、US-ASCII ではない Unicode 文字を含めることはできません。これらの文字を使用すると、セットアップ プログラムで一貫性のない動作が実行されることがあります。インストール パスには、US-ASCII 文字を使用してください。
開発用コンピューターにソリューションを発行およびインストールすると手動でアンインストールするよう求めるプロンプトが表示される
Office ソリューションをビルドすると、そのビルド バージョンが自動的に登録されます。開発用コンピューターに同じソリューションを以前に発行およびインストールして、Visual Studio Tools for Office Runtime は、ソリューションが次に実行、ビルドし直されるまたは発行された後に発行されたバージョンのインストール パスとビルド バージョンが異なることを検出します。"現在他のバージョンがインストールされており、この場所からアップグレードすることはできないため、このカスタマイズをインストールすることはできません。" というエラー メッセージが表示されます。レジストリ キーは、ソリューションがビルドされるたびに更新されます。したがって、新しいバージョンを発行するとき、デバッグまたは実行する前に、以前のバージョンをアンインストールする必要があります。
このメッセージが表示されないようにするには、開発用コンピューターで別のユーザー アカウントを作成して配置をテストします。別の方法として、前に、次の発行、デバッグ、コンピューターにインストールされているプログラムの一覧からそのバージョンをアンインストールするか、ソリューションをビルドし直します。
ソリューションをインストールするときキャッチされない例外やメソッドが見つからないエラーが発生する
配置マニフェスト (.vsto ファイル)、Office アプリケーション、ドキュメント、またはブックを開いて Office ソリューションをインストールすると、次の条件のエラー メッセージが表示される可能性があります:
メソッドが見つからない
MissingMethodException
キャッチされない例外
これらのエラー メッセージが表示されないようにするには、セットアップ プログラムを実行することにより、ソリューションをインストールします。
セットアップ プログラムを実行せずにソリューションをインストールする場合、インストーラーはのチェックしたり、必須コンポーネントをインストールします。セットアップ プログラムは、正しいバージョンの必須コンポーネントをチェックし、必要に応じて、これらをインストールします。
InstallShield Limited Edition プロジェクトのの後にアドイン用マニフェスト レジストリ キーがビルド
アドイン セットアップ プログラムに含まれるマニフェスト レジストリ キーが、.vsto から .dll.manifest に InstallShield Limited Edition プロジェクトのビルド時に変更します。
この問題を回避するには、別のソリューションの InstallShield Limited Edition プロジェクトを作成するか、アドインの名前を含むレジストリ キーの値として CompanyName.AddinName を使用します。
Office ソリューションの ClickOnce インストーラーがプライマリ相互運用機能アセンブリをインストール
ClickOnce が、Office ソリューション用に作成するセットアップ プログラムを実行すると、Office プライマリ相互運用機能アセンブリ (PIAs) のインストーラーで PIA が既にインストールされている場合にのみ実行されます。
セットアップ プログラムで PIA が正しくインストールされ、インストール ディレクトリから o2007pia.msi というインストーラー ファイルを実行して、手動でインストールします。
Office ソリューションを再インストールすると、スコープの引数から例外が発生します
Office ソリューションを再インストールするときに、ArgumentOutOfRangeException の例外は、次のエラー メッセージが表示される可能性があります: 指定された引数は、有効値の範囲内にありません。
この状況は、インストール場所の URL の大文字と小文字が違っているたとえば、このエラーは最初 https://fabrikam.com/ExcelSolution.vsto からの Office ソリューションと 2 回目に https://fabrikam.com/excelsolution.vsto はインストール表示されます。
Office ソリューションのインストール時にメッセージが、同じ大文字/小文字が表示されないようにするには。
Web からの配置マニフェストを開くことによって ClickOnce ソリューションをインストールできない
ユーザーが Web からの配置マニフェストを開いて Office ソリューションをインストールできます。ただし、インターネット インフォメーション サービス (IIS) のあるインストールは .vsto ファイル名拡張子をブロックします。Office ソリューションを配置するために使用する前に IIS で MIME 型を定義する必要があります。
IIS 6 に MIME の種類を定義する方法の詳細については、" "を参照してください。構成して、MIME の種類 (IIS 6.0) を
IIS 7 に MIME の種類を定義する方法の詳細については、" "を参照してください。MIME の種類 (IIS7) を追加します。
.vsto に拡張子と application/x ミリ秒 vstoに MIME の種類を設定します。