dotPeek をシンボルサーバーとして使用する

dotPeek Symbol Server を実行する

dotPeek シンボルサーバーの最初の起動時に、シンボルファイルを生成するアセンブリを選択するように求められます。設定オプションについては、dotPeek シンボルサーバーの設定を参照してください。

dotPeek シンボルサーバーが起動すると、対応するアイコンがステータスバーに表示されます。その上にマウスポインタを置くと、そのアドレスと現在の設定を確認できます:

dotPeek シンボルサーバーを使用するには、デバッガー設定でそのアドレスを指定します。Microsoft Visual Studio では、構成は次のとおりです。

dotPeek Symbol Server の構成

dotPeek シンボルサーバーを使用すると、シンボルファイルを生成する正確なアセンブリを選択できます。正しい構成では、望ましくないシステムアセンブリや興味のないアセンブリへのステップアップを防ぐことができます。

考えられる問題と解決策

dotPeek シンボルサーバーに問題が発生した場合、最初にできることは、プロジェクト / PDB 生成ステータスウィンドウ（dotPeek のメニューの Windows | プロジェクト / PDB 生成ログ）を開くことです。ここでは、すべてのシンボルサーバータスクと、PDB を生成するおよびプロジェクトを生成するコマンドの結果を確認できます。デバッガーによって dotPeek シンボルサーバーから一部の PDB が要求されたが、生成されなかった場合、このウィンドウに対応するエントリとエラーメッセージが表示されます。

• ほとんどの場合、ターゲットアセンブリが見つからないと問題が発生します。これを修正するには、アセンブリエクスプローラーでアセンブリを開くことができます。アセンブリの場所がわからない場合は、Visual Studio がデバッグモードのときに知ることができます - モジュールウィンドウ（デバッグ | Windows | モジュール）を開いてパス列を確認してください。

• 64 ビット Windows で dotPeek を実行している場合は、64 ビットバージョンの dotPeek を実行していることを確認してください（インストールディレクトリ %LOCALAPPDATA%\JetBrains\Installations\dotPeek[N] には dotPeek32.exe と dotPeek64.exe の 2 つの実行可能ファイルがあります）。

要求されたアセンブリがプロジェクト / PDB 生成ステータスウィンドウに表示されない場合、デバッガーはすでに対応するシンボルファイルを見つけており、dotPeek から要求していないことを意味します。シンボルファイルが正しく、ソースコードが利用可能な場合、すべてが正常であれば、dotPeek なしでアセンブリをデバッグできます。そうでない場合は、次を試してください。

• 問題のある PDB ファイルを削除または名前を変更します。Visual Studio がデバッグモードになっているときに、各アセンブリに対して実際の PDB ファイルの場所（存在する場合）を見つけることができます。モジュールウィンドウ（デバッグ | Windows | モジュール）を開き、シンボルファイル列を確認します。

• PDB ファイルが別のシンボルサーバーから受信された場合は、このサーバーを無効にするか、シンボルサーバーのリスト（Visual Studio のオプションのデバッグ | シンボル | シンボルファイルの場所）で dotPeek シンボルサーバーを移動します。

最適化されたアセンブリをデバッグする場合、一部のデバッガー機能は使用できません。たとえば、シンボルファイルが正しい場合でも、ローカル変数の値は表示されません。そのため、最適化を無効にすることができます。

• Visual Studio がデバッグモードのときにアセンブリが最適化されているかどうかを確認します。モジュールウィンドウ（デバッグ | Windows | モジュール）を開き、最適化列を確認します。

• Visual Studio オプション（ツール | オプション | デバッグ | 一般）でモジュールのロード時に JIT 最適化を抑制するチェックボックスを選択します。

• すべての NGEN（pre-JIT）イメージ（*.ni.dll）の使用を無効にするには、環境変数 COMPLUS_ZapDisable=1 を設定できます。例と詳細については、次の記事を参照してください。

  • 参照ソースをデバッグするときに最適化を無効にする方法 (英語)

  • .NET フレームワーク - RyuJIT のトラブルシューティング (英語)