Just My Code

[アーティクル]
06/10/2015

.NET Framework 言語を使用する開発者は、システム、フレームワーク、およびその他の非ユーザー呼び出しをステップオーバーし、呼び出し履歴ウィンドウでそれらの呼び出しを折りたたむ、"マイコードのみ" デバッガー機能に習熟しています。 Visual Studio 2013 で、"マイコードのみ" 機能は C++ および JavaScript 言語に拡張されました。このトピックでは、.NET Framework、ネイティブ C++、および JavaScript のプロジェクトでの "マイコードのみ" の使用について詳しく説明します。

内容

"マイコードのみ" の有効/無効の切り替え

.NET Framework での "マイコードのみ"

C++ での "マイコードのみ"

JavaScript での "マイコードのみ"

"マイコードのみ" の有効/無効の切り替え

"マイコードのみ" を有効または無効にするには、[デバッグ] メニューの [オプションと設定] をクリックします。 [デバッグ] / [全般] ノードで、[マイコードのみを有効にする] チェックボックスをオンまたはオフにします。

[オプション] ダイアログボックス内の [マイコードのみを有効にする]

注意

[マイコードのみを有効にする] の設定は、すべての言語のすべての Visual Studio プロジェクトに適用されるグローバルな設定です。

呼び出し履歴のフィルター処理のオーバーライド

"マイコードのみ" が有効な場合は、[呼び出し履歴] ウィンドウや [タスク] ウィンドウなどの呼び出し履歴の表示で、非ユーザーコードは[External Code] というラベルの注釈付きフレームに折りたたまれます。折りたたまれたフレームを表示するには、呼び出し履歴表示のコンテキストメニューで [外部コードの表示] をクリックします。

注意

[外部コードの表示] の設定は、現在のユーザーのプロファイラーに保存されます。この設定は、ユーザーによって開かれたすべての言語のすべてのプロジェクトに適用されます。

.NET Framework での "マイコードのみ"

ユーザーコードと非ユーザーコード**|ステップ実行の動作|ブレークポイントの動作|**例外の動作

ユーザーコードと非ユーザーコード

ユーザーコードと非ユーザーコードを区別するために、"マイコードのみ" 機能はプロジェクト、シンボル (.pdb) ファイル、およびプログラム最適化をチェックします。

開いている Visual Studio プロジェクトからビルドされたバイナリは、常にユーザーコードと見なされます。
デバッガーは、バイナリが最適化されているか、.pdb ファイルが入手できないとき、コードがユーザーコードであると見なします。

以下の 3 つの属性も、デバッガーが何をマイコードであると見なすかに影響を与えます。

DebuggerNonUserCodeAttribute は、適用先のコードがマイコードでないことをデバッガーに通知します。
DebuggerHiddenAttribute は、"マイコードのみ" がオフになっていても、コードをデバッガーから見えないようにするための属性です。
DebuggerStepThroughAttribute は、それが適用されているコードを (ステップインではなく) ステップスルーするよう、デバッガーに伝える属性です。

他のすべてのコードはユーザーコードであると見なされます。

ステップ実行の動作

非ユーザーコードに [ステップイン] (キーボードショートカット: F11) すると、デバッガーはそのコードを次のユーザーステートメントにステップオーバーします。 [ステップアウト] (キーボード: Shift + F11) すると、デバッガーはユーザーコードの次の行に進みます。ユーザーコードが出現しない場合は、アプリケーションが終了するか、ブレークポイントにヒットするか、または例外が発生するまで実行が続けられます。

ブレークポイントの動作

"マイコードのみ" が有効な場合は、[すべて中断] をクリックし (キーボード: Ctrl + Alt + Break)、表示するユーザーコードがない位置で実行を停止できます。停止すると、[No Source] (ソースがありません) ウィンドウが表示されます。次に [ステップ] をクリックすると、デバッガーによってユーザーコードの次の行に進められます。

例外の動作

ハンドルされない例外が非ユーザーコードで発生した場合、デバッガーはユーザーコードの例外が発生した行で停止します。

初回例外がその例外に対して有効になっている場合、ユーザーコード行は緑で強調表示されます。呼び出し履歴に、[外部コード] というラベルの注釈付きフレームが表示されます。

C++ での "マイコードのみ"

ユーザーコードと非ユーザーコード**|ステップ実行の動作|例外の動作|ステップ実行の動作のカスタマイズ|**呼び出し履歴の動作のカスタマイズ

ユーザーコードと非ユーザーコード

ステップ実行の動作が呼び出し履歴の動作に依存しないため、C++ での "マイコードのみ" は .NET Framework での "マイコードのみ" および JavaScript での "マイコードのみ" とは異なります。

呼び出し履歴

既定では、デバッガーは呼び出し履歴ウィンドウで以下の関数が非ユーザーコードであると見なします。

シンボルファイル内に除去されたソース情報がある関数。
シンボルファイルがスタックフレームに対応するソースファイルがないことを示す関数。
%VsInstallDirectory%\Common7\Packages\Debugger\Visualizers フォルダーの *.natjmc ファイルに指定された関数。

ステップ実行

既定では、%VsInstallDirectory%\Common7\Packages\Debugger\Visualizers フォルダーの *.natstepfilter ファイルに指定された関数だけが非ユーザーコードと見なされます。

%USERPROFILE%\My Documents\Visual Studio 2013\Visualizers に独自の .natstepfilter および .natjmc を作成して、ステップ実行と呼び出し履歴の動作をカスタマイズすることができます。

ステップ実行の動作

ユーザーコードから非ユーザーコードに [ステップイン] (キーボードショートカット: F11) すると、デバッガーはそのコードをユーザーコードの次の行にステップオーバーします。 [ステップアウト] (キーボード: Shift + F11) すると、デバッガーはユーザーコードの次の行に進みます。ユーザーコードが出現しない場合は、アプリケーションが終了するか、ブレークポイントにヒットするか、または例外が発生するまで実行が続けられます。

デバッガーが非ユーザーコードで実行を中断した場合 (たとえば、[すべて中断] が非ユーザーコードで停止した場合)、その非ユーザーコードでステップ実行が続けられます。

例外の動作

デバッガーの実行中に例外が発生すると、デバッガーはユーザーコードを実行中か非ユーザーコードを実行中かに関係なくその例外で停止します。 [例外] ダイアログボックスの [ユーザーにハンドルされていないとき] オプションは無視されます。

ステップ実行の動作のカスタマイズ

*.natstepfilter ファイルに関数を非ユーザーコードとして記述することで、それらの関数をステップオーバーすることを指定できます。

Visual Studio コンピューターのすべてのユーザーの非ユーザーコードを指定するには、%VsInstallDirectory%\Common7\Packages\Debugger\Visualizers フォルダーに .natstepfilter ファイルを追加します。
個々のユーザーの非ユーザーコードを指定するには、%USERPROFILE%\My Documents\Visual Studio 2013\Visualizers フォルダーに .natstepfilter ファイルを追加します。

.natstepfilter ファイルは、次の構文を使用する xml ファイルです。

<?xml version="1.0" encoding="utf-8"?>
<StepFilter xmlns="https://schemas.microsoft.com/vstudio/debugger/natstepfilter/2010">
    <Function>
        <Name>FunctionSpec</Name>
        <Action>StepAction</Action>
    </Function>
    <Function>
        <Name>FunctionSpec</Name>
        <Module>ModuleSpec</Module>
        <Action>StepAction</Action>
    </Function>
</StepFilter>

要素	説明
関数	必須。 1 つ以上の関数を非ユーザー関数として指定します。
Name	必須。一致を照合する完全な関数名を指定する ECMA-262 書式の正規表現。たとえば、次のようになります。 <Name>MyNS::MyClass.*</Name> は、MyNS::MyClass のすべてのメソッドが非ユーザーコードと見なされることをデバッガーに知らせます。一致照合では、大文字と小文字が区別されます。
Module	省略可能。関数を含むモジュールへの完全パスを指定する ECMA-262 書式の正規表現。一致では、大文字と小文字を区別しません。
Action	必須。大文字と小文字が区別される以下のいずれかの値です。 NoStepInto – 一致した関数をステップオーバーすることをデバッガーに指示します。 StepInto – 一致した関数にステップインし、一致した関数のその他の NoStepInto をオーバーライドすることをデバッガーに指示します。

呼び出し履歴の動作のカスタマイズ

モジュール、ソースファイル、および関数を *.natjmc ファイルで指定することで、呼び出し履歴でそれらを非ユーザーコードとして扱うことを指定できます。

Visual Studio コンピューターのすべてのユーザーの非ユーザーコードを指定するには、%VsInstallDirectory%\Common7\Packages\Debugger\Visualizers フォルダーに .natjmc ファイルを追加します。
個々のユーザーの非ユーザーコードを指定するには、%USERPROFILE%\My Documents\Visual Studio 2013\Visualizers フォルダーに .natjmc ファイルを追加します。

.natjmc ファイルは、次の構文を使用する xml ファイルです。

<?xml version="1.0" encoding="utf-8"?>
<NonUserCode xmlns="https://schemas.microsoft.com/vstudio/debugger/jmc/2013">
    
  <!-- Modules -->
  <Module Name="ModuleSpec" />
  <Module Name="ModuleSpec" Company="CompanyName" />
  
  <!-- Files -->
  <File Name="FileSpec"/>
  
  <!-- Functions -->
  <Function Name="FunctionSpec" />
  <Function Name="FunctionSpec" Module ="ModuleSpec" />
  <Function Name="FunctionSpec" Module ="ModuleSpec" ExceptionImplementation="true" />

</NonUserCode>

Module 要素の属性

属性	説明
Name	必須。モジュールの完全パス。 Windows のワイルドカード文字、? (0 個または 1 個の文字) および * (0 個以上の文字) を使用できます。次に例を示します。 <Module Name=”?:\3rdParty\UtilLibs\*” /> は、ドライブの \3rdParty\UtilLibs 内のすべてのモジュールを外部コードとして扱うことをデバッガーに指示します。
Company	省略可能。実行可能ファイルに埋め込まれているモジュールを発行する会社の名前。この属性を使用して、モジュールのあいまいさを解消することができます。

Name

必須。モジュールの完全パス。 Windows のワイルドカード文字、? (0 個または 1 個の文字) および * (0 個以上の文字) を使用できます。次に例を示します。

は、ドライブの \3rdParty\UtilLibs 内のすべてのモジュールを外部コードとして扱うことをデバッガーに指示します。

Company

省略可能。実行可能ファイルに埋め込まれているモジュールを発行する会社の名前。この属性を使用して、モジュールのあいまいさを解消することができます。

File 要素の属性

属性	説明
Name	必須。外部コードとして扱うソースファイルの完全パス。パスを指定するときに Windows のワイルドカード文字、? および * を使用できます。

Function 要素の属性

属性	説明
Name	必須。外部コードとして扱う関数の完全修飾名。
Module	省略可能。関数を含むモジュールの名前または完全パス。この属性を使用して、同じ名前の関数のあいまいさを解消することができます。
ExceptionImplementation	true に設定すると、この関数ではなく、例外をスローした関数が呼び出し履歴に表示されます。

JavaScript での "マイコードのみ"

ユーザーコードと非ユーザーコード**|ステップ実行の動作|ブレークポイントの動作|例外の動作|**"マイコードのみ" のカスタマイズ

ユーザーコードと非ユーザーコード

コードの分類

JavaScript の "マイコードのみ" は、以下のいずれかの方法でコードを分類することでステップ実行と呼び出し履歴表示を制御します。

MyCode	ユーザーが所有および制御するユーザーコード。
LibraryCode	ユーザーが通常使用し、アプリケーションが正しく機能するために必要なライブラリからの非ユーザーコード (WinJS や jQuery など)。
UnrelatedCode	ユーザーのアプリケーションで実行することはできるが、ユーザーが所有せず、アプリケーションが正しく機能するために直接必要としない非ユーザーコード (広告を表示する広告 SDK など)。 Windows ストアプロジェクトでは、HTTP または HTTPS URI からアプリケーションに読み込まれるコードも UnrelatedCode と見なされます。

JavaScript デバッガーは、以下のコードの種類を自動的に分類します。

ホスト提供の eval 関数に文字列を渡すことで実行されるスクリプトは、MyCode として分類されます。
Function コンストラクターに文字列を渡すことで実行されるスクリプトは、LibraryCode として分類されます。
WinJS や Azure SDK など、フレームワーク参照に含まれるスクリプトは、LibraryCode として分類されます。
setTimeout、setImmediate、または setInterval 関数に文字列を渡すことで実行されるスクリプトは、UnrelatedCode として分類されます。
%VSInstallDirectory%\JavaScript\JustMyCode\mycode.default.wwa.json は、すべての Visual Studio JavaScript プロジェクトの他のユーザーコードと非ユーザーコードを指定します。

プロジェクトのルートフォルダーに mycode.json という名前の .json ファイルを追加することで、既定の分類を変更し、特定のファイルや URL を分類することができます。

他のすべてのコードは、MyCode として分類されます。

ステップ実行の動作

関数がユーザー (MyCode) コードでない場合、[ステップイン] (キーボードショートカット: F11) は [ステップオーバー] (キーボード: F10) として動作します。
ステップが非ユーザー (LibraryCode または UnrelatedCode) コードで始まる場合、ステップ実行は一時的に "マイコードのみ" が有効でないように動作します。ステップがユーザーコードに戻ると、"マイコードのみ" のステップ実行が再び有効になります。
ユーザーコード内のステップが現在の実行コンテキストから出ることになると (イベントハンドラーの最後の行でのステップの実行など)、ユーザーコードの次に実行される行でデバッガーが停止します。たとえば、コールバックが LibraryCode コードで実行されると、デバッガーはユーザーコードの次の行が実行されるまで続行されます。
[ステップアウト] (キーボード: Shift + F11) を実行すると、ユーザーコードの次の行で停止します。ユーザーコードが出現しない場合は、アプリケーションが終了するか、ブレークポイントにヒットするか、または例外が発生するまで実行が続けられます。

ブレークポイントの動作

どのコードで設定されたブレークポイントでも、そのコードの分類とは無関係に常にヒットします。
debugger キーワードが、
- LibraryCode コードに出現した場合、デバッガーは常に中断します。
- UnrelatedCode コードに出現した場合、デバッガーは停止しません。

例外の動作

ハンドルされていない例外が、

MyCode または LibraryCode コードで発生した場合、デバッガーは常に中断します。
UnrelatedCode コードで発生し、呼び出し履歴に MyCode または LibraryCode コードがある場合、デバッガーは中断します。

[例外] ダイアログボックスで初回例外がその例外に対して有効になっている場合に、例外が LibraryCode または UnrelatedCode コードでスローされた場合、

例外が処理される場合、デバッガーは中断しません。
例外が処理されない場合、デバッガーは中断します。

"マイコードのみ" のカスタマイズ

単一の Visual Studio プロジェクトのユーザーコードと非ユーザーコードを分類するには、プロジェクトのルートフォルダーに mycode.json という名前の .json ファイルを追加します。

分類は次の順序で行われます。

既定の分類
%VSInstallDirectory%\JavaScript\JustMyCode\mycode.default.wwa.json ファイルでの分類
現在のプロジェクトの mycode. json ファイルでの分類。

分類の各手順で、前の手順はオーバーライドされます。 .json ファイルでは、すべてのキーと値のペアを示す必要はなく、MyCode、Libraries、および Unrelated の値は空の配列にすることもできます。

マイコードの .json ファイルでは、次の構文を使用します。

{
    "Eval" : "Classification",
    "Function" : "Classification",
    "ScriptBlock" : "Classification",
    "MyCode" : [
        "UrlOrFileSpec”,
        . . .
        "UrlOrFileSpec”
    ],
    "Libraries" : [
        "UrlOrFileSpec”,
        . .
        "UrlOrFileSpec”
    ],
    "Unrelated" : [
        "UrlOrFileSpec”,
        . . .
        "UrlOrFileSpec”
    ]
}

Eval、Function、および ScriptBlock

Eval、Function、および ScriptBlock のキーと値のペアで、動的に生成されたコードを分類する方法が決まります。

Eval	ホスト提供の eval 関数に文字列を渡すことで実行されるスクリプト。既定では、Eval スクリプトは MyCode として分類されます。
関数	Function コンストラクターに文字列を渡すことで実行されるスクリプト。既定では、Function スクリプトは LibraryCode として分類されます。
ScriptBlock	setTimeout、setImmediate、または setInterval 関数に文字列を渡すことで実行されるスクリプト。既定では、ScriptBlock スクリプトは UnrelatedCode として分類されます。

以下のいずれかのキーワードに値を変更できます。

MyCode は、スクリプトを MyCode として分類します。
Library は、スクリプトを LibraryCode として分類します。
Unrelated は、スクリプトを UnrelatedCode として分類します。

MyCode、Libraries、および Unrelated

MyCode、Libraries、および Unrelated のキーと値のペアは、分類に含める URL またはファイルを指定します。

MyCode	MyCodeとして分類される URL またはファイルの配列。
ライブラリ	LibraryCodeとして分類される URL またはファイルの配列。
Unrelated	UnrelatedCodeとして分類される URL またはファイルの配列。

URL またはファイルの文字列には、0 個以上の文字に一致する * 文字を 1 つ以上含めることができます。 * は、正規表現 .* と同等です。

次の方法で共有

Just My Code

内容

"マイコードのみ" の有効/無効の切り替え

呼び出し履歴のフィルター処理のオーバーライド

.NET Framework での "マイコードのみ"

ユーザーコードと非ユーザーコード

ステップ実行の動作

ブレークポイントの動作

例外の動作

C++ での "マイコードのみ"

ユーザーコードと非ユーザーコード

ステップ実行の動作

例外の動作

ステップ実行の動作のカスタマイズ

呼び出し履歴の動作のカスタマイズ

JavaScript での "マイコードのみ"

ユーザーコードと非ユーザーコード

ステップ実行の動作

ブレークポイントの動作

例外の動作

"マイコードのみ" のカスタマイズ

その他のリソース

次の方法で共有

Just My Code

内容

"マイ コードのみ" の有効/無効の切り替え

呼び出し履歴のフィルター処理のオーバーライド

.NET Framework での "マイ コードのみ"

ユーザー コードと非ユーザー コード

ステップ実行の動作

ブレークポイントの動作

例外の動作

C++ での "マイ コードのみ"

ユーザー コードと非ユーザー コード

ステップ実行の動作

例外の動作

ステップ実行の動作のカスタマイズ

呼び出し履歴の動作のカスタマイズ

JavaScript での "マイ コードのみ"

ユーザー コードと非ユーザー コード

ステップ実行の動作

ブレークポイントの動作

例外の動作

"マイ コードのみ" のカスタマイズ

その他のリソース

"マイコードのみ" の有効/無効の切り替え

.NET Framework での "マイコードのみ"

ユーザーコードと非ユーザーコード

C++ での "マイコードのみ"

ユーザーコードと非ユーザーコード

JavaScript での "マイコードのみ"

ユーザーコードと非ユーザーコード

"マイコードのみ" のカスタマイズ