dotPeek 2020.2 ヘルプ

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

dotPeek はシンボルサーバーとして機能することができます。つまり、コンパイルされたアセンブリをデバッグするために必要な情報をデバッガーに提供できます。

Microsoft Symbol Server(英語) などの従来のシンボルサーバーとは対照的に、dotPeek はシンボルファイルを保存せず、要求されたアセンブリの PDB およびソースファイルを生成し、デバッガーに返します。

dotPeek Symbol Server を実行する

  • ツールバーのシンボルサーバーの起動 / 停止 Start/Stop Symbol Server をクリックします。

  • メインメニューのツール | シンボルサーバーの起動 / 停止を選択します。

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

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

dotPeek symbol server icon in the status bar

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

dotPeek Symbol Server を使用するための Visual Studio のセットアップ

  1. Visual Studio メニューで、ツール | オプション | デバッグ | シンボルを選択します。

  2. 新しい場所を追加をクリックし、次のアドレスを指定します:http://localhost:33417/。(ポート番号は、dotPeek オプションのシンボルサーバーページで設定できます。

    Debugging symbols options in Visual Studio

  3. Visual Studio オプションで、デバッグ | 一般ページに移動し、マイコードだけを有効にするチェックボックスをオフにします。

dotPeek Symbol Server の構成

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

  1. メインメニューからツール | オプションを選択し、左側のシンボルサーバーを選択します。

  2. ラジオボタンを使用して、シンボルファイル(.pdb)を生成するオプションの 1 つを選択します。最初の 4 つの選択肢の意味は明らかです。最後の方法では、最も柔軟性があります。このオプションを選択した後は、デバッグに必要なアセンブリだけを選択して、アセンブリエクスプローラーで開くことができます。
  3. 必要に応じて、dotPeek シンボルサーバーに使用されるポート番号を変更することができます。

  4. OK をクリックします。

考えられる問題と解決策

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

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

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

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

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

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

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

最終更新日 :

関連ページ:

アセンブリの開閉

ファイル | 開くCtrl+OdotPeek を使用すると、任意の .NET アセンブリを開いたり、逆コンパイルしたり、内容を調べたりすることができます。C# コード、IL コード、または元のソースコードを PDB ファイルとシンボルサーバーを使用してローカルまたはリモートの場所からフェッチする...

プロジェクト / PDB 生成ステータスウィンドウ

Windows | Pdb の生成ステータスこのツールウィンドウは、シンボルファイルおよびプロジェクトの生成に関連するすべてのイベントを記録および表示します。このウィンドウの新規エントリは、次の場合に表示されます。dotPeek はシンボルサーバーとして機能します。この場合、シンボルファイルを生成...

PDB ファイルを生成する

デバッガー以外の場所でシンボルファイルが必要な場合、dotPeek は、.NET アセンブリ用の(ソースファイルと共に)PDB ファイルを生成するコマンドを提供します。シンボルファイルを生成するとき、dotPeek は Visual Studio のシンボルキャッシュと同じディレクトリ構造を作成しま...

アセンブリをプロジェクトにエクスポート

アセンブリを探索する究極のステップは、アセンブリを Visual Studio プロジェクトにエクスポートして、ソースコードを参照してビルドおよびデバッグできるようにすることです。アセンブリで使用された元のプログラミング言語とは無関係に、エクスポートされたプロジェクトは C# を使用して作成されます...