次の方法で共有


DkmEngineSettings クラス

定義

セッション全体のデバッグ設定が含まれます。 このオブジェクトのインスタンスは、エンジン Guid ごとに 1 つあります (たとえば、COMPlusOnlyEng2 のインスタンスは 1 つ、COMPlusNativeEng の場合は 1 つのインスタンス)。

public ref class DkmEngineSettings : Microsoft::VisualStudio::Debugger::DkmDataContainer
[System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")]
public class DkmEngineSettings : Microsoft.VisualStudio.Debugger.DkmDataContainer
[<System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")>]
type DkmEngineSettings = class
    inherit DkmDataContainer
Public Class DkmEngineSettings
Inherits DkmDataContainer
継承
継承
DkmEngineSettings
属性

プロパティ

AllowOutOfProcessSymbolLoading

true の場合、デバッガーは別のプロセスでネイティブ シンボルを読み込みます。

この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) で導入されました。

BaseDebugMonitorId

このエンジンで使用されるベース デバッグ モニター。 エンジンがデバッグ中のプロセスに応じてさまざまな基本デバッグ モニターを使用する場合、この値は Guid.Empty (GUID_NULL) になることがあります。

ClrDebuggingServicesId

このプロセスのデバッグ時に使用する CLR デバッグ サービスのバージョン (mscordbi.dll またはその他の ICorDebug API の実装) を示します。

DataBreakpointAsString

データ ブレークポイント記述子を文字列として扱う必要がある場合。

この API は Visual Studio 16 RTM (DkmApiVersion.VS16RTM) で導入されました。

DotnetVisualizerExtensionInfos

[省略可能]VSIX パッケージ経由でインストールされ、拡張機能パーツ マネージャーによって管理される .NET カスタム デバッガー ビジュアライザーに関する関連情報を保持します。

この API は、Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) で導入されました。

EnableAsyncDebugging

'await' ステートメントをステップオーバーし、非同期メソッドからステップアウトできるようにします。 これは既定でオンになっています。

EnableFuncEvalQuickAbort

このデバッグ・セッションに対してこのエンジンに対して FEQA が使用可能かどうかを指定します。

EngineId

これらは、"標準" エンジンの GUID 値です。 この一覧は時間の経過と同時に増加することが予想されるため、可能であれば、EngineId を比較するのではなく、設定のクエリを実行することをお勧めします。

Flags

このエンジン設定の不変の特性を示すフラグ。

FuncEvalAbortLoggingLevel

func eval が中止されたとき、または失礼な中止が発生したときに、デバッグ対象のダンプを作成するかどうかを示すために使用されます。

この API は、Visual Studio 15 Update 4 (DkmApiVersion.VS15Update4) で導入されました。

FuncEvalQuickAbortExcludeList

FEQA DLL が読み込まれている場合でも FEQA が有効になっていない実行可能ファイルの一覧。

ImageDebugDirectoryFormats

IMAGE_DEBUG_DIRECTORYでサポートされている値の一覧。型。

IsAutomaticDecompilationEnabled

true の場合、他のソースからシンボル情報を使用できない場合、モジュールは自動的に逆コンパイルされる可能性があります。

この API は、Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) で導入されました。

IsEditAndContinue

エディット コンティニュを有効にします。

この API は Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。

IsFastEvaluateAllowed

true (既定の状態) の場合、CLR インスペクターは func-eval を使用するのではなく、場合によっては単純なプロパティ/メソッドの解釈を試みます。 より複雑なメソッドは、func-eval を使用して評価されます。

この API は Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2) で導入されました。

IsGpuRaceHazardsAllowSameSettingEnabled

true の場合、デバッガーは、前のデータを変更しなかった GPU 競合の危険性を無視します。

IsJustMyCodeEnabled

true の場合、デバッガーは JustMyCode 機能 (ステップ実行、呼び出し履歴、例外フィルター処理) を有効にします。

IsNativeExportsEnabled

true の場合、デバッガーは Win32 PE ファイルからエクスポート テーブルを使用してアドレスを解決しようとします。

IsNativeJustMyCodeSteppingEnabled

true の場合、デバッガーはネイティブに対してマイ コードのステップ実行のみを有効にします (モジュールが /JMC スイッチでコンパイルされている場合)。

この API は、Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8) で導入されました。

IsStepOverPropertiesAndOperatorsEnabled

true の場合、ステップ インが完了すると、デバッガーはプロパティと演算子をステップ オーバーします。

IsSuppressOptimizationsEnabled

true の場合、デバッガーは、新しく読み込まれたモジュールに対する Just-In-Time コンパイラの最適化を抑制します。

IsUnloaded

このオブジェクトに対して 'unloaded' イベントが発生した場合 (例: DkmThread::Unload が呼び出された場合)、またはオブジェクトが閉じている場合は true を返します。 この状態を同期せずに確認する場合は、読み取った後に返される状態が正確でなくなる可能性があるため、注意が必要です。

(継承元 DkmDataContainer)
Languages

このプロセスのデバッグ中にサポートされているすべてのプログラミング言語のコレクション。

MaxCallStackFrames

呼び出し履歴ウィンドウでサポートされるフレームの最大数。

この API は Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。

NativeEESettings

[省略可能]ネイティブ式エバリュエーターの構成設定が含まれます。

この API は、Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) で導入されました。

RegistryTweaks

[省略可能]コンポーネントが動作をカスタマイズするために使用する可能性がある Visual Studio レジストリのレジストリ調整の一覧。 レジストリの調整は、各デバッグ セッションの開始時にキー [Visual Studio レジストリ ルート]\Debugger\EngineSwitches から読み取られます。

この API は Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。

RemoteClrPdbNamePatterns

PDB がリモート側に読み込まれるかどうかを判断するために使用される PDB 名パターンの一覧。

RequireFullTrustForSourceServer

true の場合、デバッガーでは、アセンブリからソース サーバー コマンドを実行する前に、アセンブリを完全に信頼する必要があります。 完全に信頼される という概念は、CLR アセンブリにのみ適用されます。

SymbolPaths

シンボル検索パスとキャッシュ パスを表す DkmStrings のコレクション。

TraceSettings

[省略可能]WPF 出力のトレース設定。

この API は Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。

ValidateFilesForMinidumps

True を指定すると、デバッガーは、CLR デバッグ ライブラリのデジタル署名を読み込む前に検証する必要があります。 名前にもかかわらず、この設定は実際にはすべての種類のデバッグに使用されることに注意してください。

この API は Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。

メソッド

FindProcess(Guid)

この DkmEngineSettings 内で DkmProcess 要素を見つけます。 指定された入力キーを持つ要素が存在しない場合、FindProcess は失敗します。

FindSettings(Guid)

DkmEngineSettings オブジェクトを検索します。 指定された入力キーを持つオブジェクトが存在しない場合、FindSettings は失敗します。

GetCodeViewCompilers()

DkmCodeViewCompilerId 値の列挙を返します。 その後、この列挙をシンボル プロバイダーが使用して、コード ビュー レコード内の情報を DkmCompilerId 構造体にマップできます。

GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>)

追加の Clr ランタイム パスを取得します。

この API は、Visual Studio 17 Update 1 (DkmApiVersion.VS17Update1) で導入されました。

GetDataItem<T>()

このコンテナー インスタンスに追加された 'T' のインスタンスを取得します。 このコンテナーに 'T' が含まれていない場合、この関数は null を返します。

(継承元 DkmDataContainer)
GetLanguage(DkmCompilerId)

指定されたコンパイラ ID と一致する DkmLanguage オブジェクトを返します。言語が不明 (エンジンに登録されていない) 場合、このメソッドは既定の言語オブジェクトを返します。

GetProcesses()

GetProcesses は、この DkmEngineSettings オブジェクトの DkmProcess 要素を列挙します。

GetSettings()

GetSettings は、作成されたすべての DkmEngineSettings オブジェクトを列挙します。

GetUserDocumentPath()

ユーザー ドキュメントの Visual Studio フォルダー パスを取得します。

RemoveDataItem<T>()

このコンテナーから 'T' のインスタンスを削除します。 通常、オブジェクトが閉じられるとデータ コンテナーが自動的に空になるので、このメソッドを呼び出す必要があります。

(継承元 DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

データ コンテナーに新しい項目を配置します。

(継承元 DkmDataContainer)

適用対象