VSPackage に関する問題のトラブルシューティング

2024-12-14

適用対象: Visual Studio

この記事では、 VSPackages に関する一般的な問題とトラブルシューティングのヒントについて説明します。

VSPackage によって Visual Studio の起動が維持される

このシナリオでは、コマンドプロンプトで devenv.exe /safemode を入力して、Visual Studio をセーフモードで起動します。このプロセスでは、Visual Studio に含まれる VSPackage を除き、VSPackage は読み込まれません。

VSPackage が読み込まれない

この問題のトラブルシューティングを行うには、次の 1 つ以上の手順を試してください。

VSPackage が実行に登録されているレジストリルート (通常は実験用レジストリルート) を使用していることを確認します。詳細については、「実験用インスタンス」を参照してください。
VSPackage が実験用レジストリルートで実行されるように設定されている場合は、実験用バージョンの Visual Studio を実行していることを確認します。

試験段階のバージョンを実行するには、Visual Studio コマンドプロンプトを開き、「 devenv /rootsuffix exp」と入力します。
VSPackage レジストリエントリを確認します。詳細については、VSPackage の登録に関するページと「VSPackage を管理する」を参照してください。
VSPackage の読み込みに失敗している Visual Studio のインスタンスの [出力] ウィンドウを開きます。 VSPackage が読み込みに失敗している理由に関する情報が、そのウィンドウに表示されることがあります。

Note

Visual Studio の実験用バージョンを Visual Studio 統合開発環境 (IDE) から起動している場合は、両方のバージョンの [出力] ウィンドウを調べます。
アクティビティログを調べます。詳細については、「方法: アクティビティログを使用する」を参照してください。
IDE によってスローされる例外の詳細については、Debug メニューの Exceptions を選択して例外を有効にします。 [例外] ダイアログボックスで、詳細情報が必要な例外の種類を選択します。

VSPackage が登録されていない

VSPackage アセンブリが信頼できる場所にあることを確認します。 RegPkg は、既定の .NET セキュリティ構成のネットワーク共有など、信頼されていない場所または部分的に信頼された場所にアセンブリを登録できません。ユーザーが信頼されていない場所にプロジェクトを作成するたびに警告が表示されますが、 このメッセージを再度表示しない場合 チェックボックスをオンにすると、この警告が繰り返し発生しないようにすることができます。

コマンドが表示されないか、選択するとエラーが生成される

この問題を解決するには、次の手順を試してください。

Visual Studio コマンドプロンプトで devenv /rootsuffix Exp /setup を入力して、新しいメニューコマンドまたは変更されたメニューコマンドと IDE に既に含まれているコマンドをマージします。
Visual Studio で VSPackage の UI.dll が見つかることを確認します。
1. レジストリの Packages セクションで、VSPackage の CLSID を探します。
  
  HKLM\Software\Microsoft\Visual Studio\<version>\Packages
2. SatelliteDll サブキーによって指定されたパスが正しいことを確認します。

VSPackage が予期せず動作する

この問題のトラブルシューティングを行うには、次の 1 つ以上の手順を試してください。

コード内にブレークポイントを設定します。

デバッグの開始点としては、コンストラクターと初期化メソッドを使用することをお勧めします。また、メニューコマンドなど、評価する領域にブレークポイントを設定することもできます。ブレークポイントを有効にするには、デバッガーで実行する必要があります。
1. [プロジェクト] メニューの [プロパティ] を選択します。
2. [プロパティページ] ダイアログボックスで、[デバッグ] タブをクリックします。
3. [ コマンド行引数 ボックスに、VSPackage がターゲットとする開発環境のルートサフィックスを入力します。たとえば、実験用ビルドを選択するには、「 /RootSuffix Exp」と入力します。
4. Debug メニューの [デバッグの開始] 選択するか F5 キーを押します。
  
  Note
  
  プロジェクトをデバッグする場合は、ここでプロジェクトを作成するか、既存のインスタンスを読み込みます。
アクティビティログを使用します。

キーポイントでアクティビティログに情報を書き込むことによって、VSPackage の動作をトレースします。この手法は、製品版環境で VSPackage を実行する場合に特に役に立ちます。詳細については、「方法: アクティビティログを使用する」を参照してください。
パブリックシンボルを使用します。

デバッグ中の読みやすさを向上させるために、デバッガーにシンボルをアタッチできます。
1. [ツール] - [オプション] メニューを選択し、[デバッグ] - [シンボル] ダイアログボックスに移動します。
2. Symbol ファイル (.pdb) の場所: https://msdl.microsoft.com/download/symbolsを追加します。
3. パフォーマンスを向上させるには、シンボルキャッシュフォルダーを指定します (例: C:\symbols。

VSPackage またはその依存関係のいずれかが見つからない

マネージドコードの場合は、参照パスが正しいことを確認します。
1. [プロジェクト] メニューの [プロパティ] を選択します。
2. [プロパティページ] ダイアログボックスの [参照] タブを選択し、すべてのパスが正しいことを確認します。または、オブジェクトブラウザーを使用して、参照先オブジェクトを参照することもできます。
  
  マネージドコードの場合は、Fuslogvw.exe (アセンブリバインディングログビューアー) を使用して、失敗したアセンブリの読み込みの詳細を表示できます。
アンマネージドコードの場合は、Visual Studio CLSID レジストリノード内で VSPackage の CLSID を見つけます:

HKLM\Software\Microsoft\Visual Studio\<version>\CLSID

InprocServer32 エントリに VSPackage DLL の正しいパスがあることを確認します。

次の方法で共有