DkmInspectionContext クラス

定義

名前空間:

Microsoft.VisualStudio.Debugger.Evaluation

アセンブリ:

Microsoft.VisualStudio.Debugger.Engine.dll

パッケージ:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

検査操作の実行中に使用するオプションとターゲット コンテキスト。

public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
class DkmInspectionContext

[System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")]
public class DkmInspectionContext

[<System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")>]
type DkmInspectionContext = class

Public Class DkmInspectionContext

継承

Object

DkmInspectionContext

属性

GuidAttribute

プロパティ

AdditionalVisualizationData	[省略可能]ユーザー プロファイル ディレクトリと Visual Studio インストール ディレクトリの既定のファイルに加えて、使用する視覚化ファイルへの完全なパスの省略可能な一覧を指定します。 これらのパス内の競合するビジュアライザー間の優先順位は、"AdditionalVisualizationDataPriority" で指定された情報に従って解決されます。 この API は、Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。
AdditionalVisualizationDataPriority	AdditionalVisualizationData が指定されている場合は、既定の検索場所を基準にして、このようなデータの優先順位を指定します。 この API は、Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。
EvaluationFlags	入力式の解析、コンパイル、または表示方法に影響を与えるフラグ。
FuncEvalFlags	関数評価要求の実行方法に影響を与えるフラグ。
InspectionSession	InspectionSession を使用すると、ターゲット プロセス内のデータを調べるさまざまなコンポーネントが、同じ有効期間でプライベート データを格納できます。 ユーザーがプロセスを続行しようとすると、検査セッションは閉じられます。
Language	検査の実行に使用される言語。
Radix	整数データを書式設定するときに使用する基数。 現在サポートされている値は、'16' と '10' です。
ReturnValue	[省略可能]非推奨 - を使用しないでください。 代わりに、コンポーネントは ReturnValues プロパティをすべての戻り値のリストとして使用し、リスト内の最後の戻り値アイテムを表す$ReturnValueを設定する必要があります。
ReturnValues	[省略可能]$ReturnValue 1、$ReturnValue 2 などの値の生表現。 この API は Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。
RuntimeInstance	この評価の実行に使用するランタイム モニターを示します。
SymbolsConnection	[省略可能]null 以外の場合、この検査操作のシンボルが処理されるワーカー プロセスへの接続を指定します。 IDE プロセスにシンボルが読み込まれる場合、またはリモート デバッガーに読み込まれる場合 (DkmModule.Connection が null 以外の場合) は null になります。 この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) で導入されました。
Thread	検査対象のスレッド。
Timeout	これは、関数の評価などの操作が遅くなる可能性がある場合に使用されるタイムアウトです。 この値の単位はミリ秒です。

メソッド

ClrExpressionMayRequireParentheses(String)	言語のサブ式として使用する場合、式にかっこが必要な場合は true を返します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue)	新しい DkmInspectionContext オブジェクト インスタンスをCreateします。
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority)	新しい DkmInspectionContext オブジェクト インスタンスをCreateします。 この API は、Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>)	新しい DkmInspectionContext オブジェクト インスタンスをCreateします。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>, DkmWorkerProcessConnection)	新しい DkmInspectionContext オブジェクト インスタンスをCreateします。 この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) で導入されました。
EvaluateExpression(DkmWorkList, DkmLanguageExpression, DkmStackWalkFrame, DkmCompletionRoutine<DkmEvaluateExpressionAsyncResult>)	入力式をバインドして評価します。 次に、デバッガーに表示する結果の値を書式設定します。 これは、データ ヒント、watch ウィンドウ、イミディエイト ウィンドウなどに使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: IDE コンポーネントは、デバッグ対象のコードの種類に関係なく、このメソッドを呼び出す場合があります。 現在、このメソッドは、CLR で実行されているコードをデバッグするときに、デバッグ モニター コンポーネントでもサポートされています。ただし、この機能は将来のバージョンで削除される可能性があります。
EvaluateExpressionOnThreads(DkmWorkList, ReadOnlyCollection<UInt64>, DkmStackWalkFrame, DkmLanguageExpression, DkmCompletionRoutine<DkmEvaluateExpressionOnThreadsAsyncResult>)	入力式をバインドして評価します。 次に、デバッガーに表示する結果の値を書式設定します。 これは、データ ヒント、watch ウィンドウ、イミディエイト ウィンドウなどに使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。
EvaluateReturnValue(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValue, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult>)	指定されたデータのみを使用して、指定された DkmRawReturnValue を評価および書式設定します。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。
EvaluateReturnValue2(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValueContainer, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult2>)	指定されたデータのみを使用して、指定された DkmRawReturnValue を評価および書式設定します。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。
GetClrArrayIndexExpression(String[])	配列インデックス式を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrCastExpression(String, DkmClrType, DkmClrCustomTypeInfo, DkmClrCastExpressionOptions)	有効な構文の場合は、キャスト式を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrExpressionAndFormatSpecifiers(String, ReadOnlyCollection<String>)	文字列を式と書式指定子の部分に分割します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrExpressionForNull()	null (キーワード (keyword)) の言語固有の式を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrExpressionForThis()	this/Me の言語固有の式を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrLocalVariableQuery(DkmClrInstructionAddress, Boolean)	DkmCompiledClrLocalsQuery を取得して、ローカル変数を表示できるようにします。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。
GetClrMemberName(String, DkmClrType, DkmClrCustomTypeInfo, String, Boolean, Boolean)	有効な構文として表現できる場合は、メンバー アクセス式を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrNameForField(DkmClrModuleInstance, Int32)	メタデータから識別子の言語固有の名前を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) で導入されました。
GetClrNameForLocalVariable(DkmClrModuleInstance, DkmClrMethodId, DkmILRange, DkmClrLocalVariable)	メタデータから識別子の言語固有の名前を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) で導入されました。
GetClrObjectCreationExpression(DkmClrType, DkmClrCustomTypeInfo, String[])	有効な構文の場合は、オブジェクト作成式を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrTypeName(DkmClrType, DkmClrCustomTypeInfo)	有効な構文の場合は、言語で有効なフォームで型名を取得します。 このメソッドは、有効な構文がない場合に null をエスケープまたは返す機能を持つ有効なフル ネームを構築するためのメソッドです。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetClrValidIdentifier(String)	言語で有効なフォームで識別子を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。
GetFrameArguments(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameArgumentsAsyncResult>)	スタック フレームの引数に関する情報を提供します。 これは現在、VS オートメーション モデル (EnvDTE.StackFrame.Arguments) を介してのみ公開されています。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: IDE コンポーネントは、デバッグ対象のコードの種類に関係なく、このメソッドを呼び出す場合があります。 現在、このメソッドは、CLR で実行されているコードをデバッグするときに、デバッグ モニター コンポーネントでもサポートされています。ただし、この機能は将来のバージョンで削除される可能性があります。
GetFrameLocals(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameLocalsAsyncResult>)	このスタック フレームのローカル変数を取得するために使用される列挙コンテキストを取得します。 これは、ローカル ウィンドウの計算で使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: IDE コンポーネントは、デバッグ対象のコードの種類に関係なく、このメソッドを呼び出す場合があります。 現在、このメソッドは、CLR で実行されているコードをデバッグするときに、デバッグ モニター コンポーネントでもサポートされています。ただし、この機能は将来のバージョンで削除される可能性があります。
GetFrameName(DkmWorkList, DkmStackWalkFrame, DkmVariableInfoFlags, DkmCompletionRoutine<DkmGetFrameNameAsyncResult>)	スタック フレームのテキスト表現を提供します。 これは、書式設定された呼び出し履歴を構築するときに使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。 場所の制約: IDE コンポーネントは、デバッグ対象のコードの種類に関係なく、このメソッドを呼び出す場合があります。 現在、このメソッドは、CLR で実行されているコードをデバッグするときに、デバッグ モニター コンポーネントでもサポートされています。ただし、この機能は今後のバージョンで削除される可能性があります。
GetFrameReturnType(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameReturnTypeAsyncResult>)	1 つ以上のスタック フレームの戻り値の型のテキスト表現を提供します。 現在、これは VS オートメーション モデル (EnvDTE.StackFrame.ReturnType) でのみ公開されています。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。
GetTypeName(DkmClrType, DkmClrCustomTypeInfo, ReadOnlyCollection<String>)	指定した DkmClrType の UI に表示する型名文字列を取得します。 このメソッドは常に値を返し、変数検査ウィンドウで使用されます。 場所の制約: API は Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。
WithProperties(UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32)	EvaluationFlags や Radix などの更新された指定されたプロパティを使用して、元の DkmInspectionContext のコピーを作成します。 プロパティは元のプロパティの完全な置換であり、元のプロパティにはマージされません。 そのため、元の DkmInspectionContext から必要なプロパティをこのメソッドに提供する必要があります。 この API は、Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8) で導入されました。