DebuggableAttribute.DebuggingModes 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DebuggableAttribute.DebuggingModes 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

Just-In-Time (JIT) コンパイラ用のデバッグモードを指定します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

名前空間: System.Diagnostics
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
<FlagsAttribute> _
Public Enumeration DebuggingModes

Visual Basic (使用法)

Dim instance As DebuggingModes

[ComVisibleAttribute(true)] 
[FlagsAttribute] 
public enum DebuggingModes

C++

[ComVisibleAttribute(true)] 
[FlagsAttribute] 
public enum class DebuggingModes

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute FlagsAttribute() */ 
public enum DebuggingModes

JScript

ComVisibleAttribute(true) 
FlagsAttribute 
public enum DebuggingModes

メンバ

	メンバ名	説明
	Default	最適化の有効化、エディットコンティニュのサポートの無効化、シンボルストアシーケンスポイントの使用 (存在する場合) など、既定の動作を使用するよう Just-In-Time (JIT) コンパイラに指示します。.NET Framework Version 2.0 では、JIT 追跡情報 (メソッド内のネイティブコードオフセットに対する MSIL (Microsoft Intermediate Language) オフセットの情報) が常に生成されます。
	DisableOptimizations	コンパイラで実行する最適化を無効にします。最適化は、出力ファイルのサイズを小さくして、速度と効率を向上させるために実行します。最適化によって出力ファイルのコードの配置が変更されると、デバッグが困難になる可能性があります。通常、デバッグ中は最適化を無効にします。
	EnableEditAndContinue	エディットコンティニュを有効にします。エディットコンティニュを使用すると、プログラムの中断モード時にソースコードに変更を加えることができます。エディットコンティニュ機能はコンパイラに依存します。
	IgnoreSymbolStoreSequencePoints	プログラムデータベース (PDB) シーケンスポイントではなく、暗黙の MSIL シーケンスポイントを使用します。通常、シンボリック情報には、ソース行ごとに少なくとも 1 つの MSIL オフセットが含まれています。Just-In-Time (JIT) コンパイラは、メソッドをコンパイルするとき、保存する必要がある MSIL オフセットのリストをプロファイリングサービスに要求します。この MSIL オフセットをシーケンスポイントと呼びます。
	None	.NET Framework Version 2.0 では、JIT 追跡情報が常に生成されます。このフラグは、IsJITTrackingEnabled プロパティが false である場合を除き (これは Version 2.0 では効果はありません)、Default と同じ効果があります。

解説

DebuggableAttribute.DebuggingModes 列挙体は、ランタイムがコード生成中にデバッガにとって重要な情報をどのように追跡するかを制御します。この情報は、デバッガが豊富なデバッグ機能を提供するのをサポートします。.NET Framework Version 2.0 で、modes パラメータの値に Default を設定して DebuggableAttribute(DebuggingModes) コンストラクタを呼び出すことは、.NET Framework Version 1.1 で isJITTrackingEnabled パラメータの値に true を設定して DebuggableAttribute(Boolean,Boolean) コンストラクタを呼び出すことに相当します。Version 1.1 とは異なり、Version 2.0 では Just-In-Time (JIT) コンパイラによる追跡を無効にすることはできません。JIT 追跡は、デバッグ可能なファイルでは常に有効になります。

シーケンスポイントは、ブレークポイントを設定する場合など、デバッガユーザーが一意に参照できることを求める MSIL (Microsoft Intermediate Language) コード内の位置を示すために使用されます。JIT コンパイラは、2 つの異なるシーケンスポイントの MSIL を単一のネイティブ命令にコンパイルしないことを保証します。既定では、JIT コンパイラは、プログラムデータベース (PDB: Program Database) ファイル内のシンボルストアで、追加されたシーケンスポイントのリストをチェックします。ただし、PDB ファイルを読み込む場合、ファイルが使用可能であることが必要であり、パフォーマンスに悪影響を及ぼします。Version 2.0 では、コンパイラは MSIL の "nop" 命令を使用することにより、MSIL コードストリーム内の "暗黙のシーケンスポイント" を生成できます。この場合、コンパイラは IgnoreSymbolStoreSequencePoints フラグを設定し、PDB ファイルを読み込まないよう共通言語ランタイムに通知する必要があります。

メモ
この列挙体は、主に言語開発者によって使用されます。通常は、アプリケーション開発では使用されません。開発環境では、/debug や /optimize のようなコンパイラパラメータに基づいて DebuggableAttribute.DebuggingModes を使用します。