方法: シンボルの場所と読み込み動作を指定する
このトピックの内容は、次の製品に該当します。
エディション |
Visual Basic |
C# |
F# |
C++ |
Web Developer |
---|---|---|---|---|---|
Express |
|||||
Pro、Premium、Ultimate |
アプリケーションをデバッグするには、PDB ファイルに格納されているシンボル情報が必要です。 場合によっては、シンボル情報は以前の形式の DBG ファイル内にあることもあります。 ユーザーのアプリケーションおよびサードパーティまたはシステムの DLL をデバッグする場合は、シンボル ファイルが必要です。 シンボル ファイルは、コンピューター上のディレクトリに格納することも、シンボル サーバーからダウンロードすることもできます。
既定では、デバッガーは EXE が置かれている場所からシンボル ファイルを読み込みます。 別のディレクトリまたはシンボル サーバーからシンボルを使用するには、その場所を Visual Studio に指定する必要があります。
デバッグ セッションを開始すると、Visual Studio によってシンボルが自動的に読み込まれます。 シンボルを自動的に読み込む対象のモジュールを指定できます。 モジュールのシンボルを自動的には読み込まないようにした場合は、[モジュール] ウィンドウを使用して、手動でシンボルを別に読み込むことができます。
シンボル サーバーの使用方法については、「方法 : シンボル サーバーを使用する」を参照してください。 シンボル サーバーを使用する場合は、そのサーバーが信頼できることを確認してください。 そうしないと、セキュリティ上の脅威にさらされる可能性があります。
シンボル ファイルが置かれているディレクトリを指定するには
[ツール] メニューの [オプション] をクリックします。
[オプション] ダイアログ ボックスで、[デバッグ] ノードを展開し、[シンボル] をクリックします。
[シンボル] ページが開きます。このページには、[シンボル ファイル (.pdb) の場所] というボックスがあります。 このボックスの上に 4 つのアイコンがあります。
フォルダー アイコンをクリックします。
編集可能なテキストが [シンボル ファイル (.pdb) の場所] ボックスに表示されます。
ディレクトリ パスを入力します。 ステートメント入力候補により、正しい形式を確認できます。
リモート デバッグを行う場合、マネージ コードのシンボル ファイルとシンボル サーバーのキャッシュは、リモート コンピューターに配置する必要があります。 ネイティブ コードのシンボル ファイルとシンボル サーバーのキャッシュは、ローカル コンピューターに配置する必要があります。
リモート シンボル サーバーのシンボルを使用している場合、シンボルのコピーを格納するローカル ディレクトリを指定すると、パフォーマンスが向上します。 これを行うには、[このディレクトリにシンボルをキャッシュ] ボックスにパスを入力します。 リモート コンピューター上のプログラムをデバッグしている場合、キャッシュ ディレクトリは、リモート コンピューター上のディレクトリになります。
[OK] をクリックします。
シンボルのパスの一覧からパス名を削除するには
[オプション] ダイアログ ボックスを開き、上の手順の説明に従って、[シンボル] ページに移動します。
[シンボル ファイル (.pdb) の場所] ボックスでパスを選択します。
赤い X アイコンをクリックします。
[OK] をクリックします。
自動的に読み込むシンボルを指定するには
[オプション] ダイアログ ボックスを開き、上の手順の説明に従って、[シンボル] ページに移動します。
[次のシンボルを自動的に読み込む] で、[除外されていないすべてのモジュール] または [指定したモジュールのみ] をクリックします。
[除外されていないすべてのモジュール] を選択した場合は、[除外されるモジュールの指定] をクリックできるようになります。
[自動読み込みから除外するシンボル] ダイアログ ボックスが表示されます。
ドキュメント アイコンをクリックしてモジュールを [モジュール] ボックスの一覧に追加するか、[モジュール] ボックスの一覧でモジュールを選択し、X アイコンをクリックしてモジュールを削除します。
終了したら、[OK] をクリックします。
[指定したモジュールのみ] を選択した場合は、[モジュールの指定] をクリックできるようになります。
[自動的に読み込むシンボル] ダイアログ ボックスが表示されます。
ドキュメント アイコンをクリックしてモジュールを [モジュール] ボックスの一覧に追加するか、[モジュール] ボックスの一覧でモジュールを選択し、X アイコンをクリックしてモジュールを削除します。
既定では、アプリケーション モジュールのディレクトリに置かれているシンボルが常に読み込まれます。 この既定の動作をやめるには、[モジュールと同じ場所にあるシンボルを常に読み込む] チェック ボックスをオフにします。
終了したら、[OK] をクリックします。
[OK] をクリックします。
手動によるシンボルの読み込み
シンボルは、[モジュール] ウィンドウから手動で読み込むことができます。 この機能は、Visual Basic、Visual C#、および Visual Web Developer Express Edition では実行できません。
シンボルを手動で読み込むには
[モジュール] ウィンドウを右クリックし、[シンボルの読み込み元] をポイントし、[シンボル パス] または [Microsoft シンボル サーバー] をクリックします。
デバッガーがシンボル パスまたはシンボル サーバーを検索して、シンボルを見つけます。 シンボルが見つからない場合は、[シンボル検索] ダイアログ ボックスが表示されます。
[シンボル検索] ダイアログ ボックスで、読み込むシンボル ファイルを指定し、[OK] をクリックします。
シンボル ファイルは .pdb ファイルまたは .dbg ファイルです。
参照
参照
Symbols, Debugging, Options Dialog Box
概念
プログラム データベース ファイル (C#、F#、および Visual Basic)
システム コール中のクラッシュのデバッグに必要なシンボルのインストール