シンボルサーバーとしての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]に2つの実行可能ファイル - dotPeek32.exe と dotPeek64.exe があります）。

要求されたアセンブリが プロジェクト/ 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のトラブルシューティング(英語)