DkmClrValue クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
CLR 検査クエリの結果の値。 これらの値は、DkmEvaluationResults を生成するために結果フォーマッタによって使用されます。
この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。
public ref class DkmClrValue : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable
[System.Runtime.InteropServices.Guid("8186570c-2529-edb5-ef0b-4e485f902e89")]
public class DkmClrValue : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable
[<System.Runtime.InteropServices.Guid("8186570c-2529-edb5-ef0b-4e485f902e89")>]
type DkmClrValue = class
inherit DkmDataContainer
interface IDisposable
Public Class DkmClrValue
Inherits DkmDataContainer
Implements IDisposable
- 継承
- 継承
- 属性
- 実装
プロパティ
Access |
評価結果のアクセス制御レベル (パブリック、プライベートなど)。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
Address |
[省略可能]結果がアドレスである場合 (つまり、アドレス フラグが Flags で設定されている場合)、バッキング値の場所を指定します。 これは、評価結果がメモリ ウィンドウまたは逆アセンブル ウィンドウへの入力として使用される場合に使用されます。 命令アドレスの場合は、CPUInstruction アドレスが設定されている必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
Alias |
[省略可能]この値のエイリアス。 オブジェクトに別名が割り当てられていない場合、この値は null になります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
ArrayDimensions |
[省略可能]配列の次元。 この値は、この DkmClrValue が配列値の場合にのみ有効です。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
ArrayLowerBounds |
[省略可能]配列の下限。 この値は、この DkmClrValue が配列値の場合にのみ有効です。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
Category |
この評価結果のカテゴリ (例: データ、メソッドなど)。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
EvalFlags |
この DkmClrValue を作成した評価の結果を示すフラグ。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
HostObjectValue |
[省略可能]DkmClrValue がデバッガー プロセスで表すことができる値である場合、このノードの値。 DkmClrValue が複合型の場合、この値は null になります。 基になる値が文字列である場合のネイティブ コードでの使用に関する注意: ネイティブ コードでこのフィールドを使用する場合、VARIANT 構造体は BSTR または IUnknown であり、IDkmManagedStringRef に対してクエリを実行する必要があります。 このフィールドをネイティブ コードで作成する場合は、BSTR の VARIANT を使用します。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
InspectionSession |
InspectionSession を使用すると、ターゲット プロセス内のデータを調べるさまざまなコンポーネントが、同じ有効期間でプライベート データを格納できます。 検査セッションは、ユーザーがプロセスを続行しようとすると閉じられます。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
IsNull |
True の場合、値が null (または値がない場合) です。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
IsUnloaded |
このオブジェクトに対して 'unloaded' イベントが発生した場合 (例: DkmThread::Unload が呼び出されます)、またはオブジェクトが閉じている場合は true を返します。 同期なしでこの状態を確認する場合は、読み取った後に返される状態が正確でなくなる可能性があるため、注意が必要です。 (継承元 DkmDataContainer) |
Language |
使用されている言語。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
NativeComPointer |
この値が RCW の場合は、ネイティブ COM オブジェクトへのインターフェイス ポインター。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
StackFrame |
解釈された式の検査フレームとして使用されるスタック フレーム。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
StorageType |
評価結果のストレージの種類 (例: 静的)。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
Type |
[省略可能]このノードのランタイムの種類。 たとえば、System.String です。 値が無効で、型を特定できない場合、この値は null です。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
TypeModifierFlags |
評価結果の型修飾子フラグ (例: const)。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
UniqueId |
この解釈された結果を一意に識別する Guid。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
ValueFlags |
この値を記述するフラグ。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
メソッド
Close() |
CLR 値を閉じて、それに関連付けられているリソースを解放します。 このメソッドは、評価クエリを要求したオブジェクトによって呼び出される必要があります (例: DkmCompiledClrInspectionQuery.Execute と呼ばれます)。 DkmClrValue オブジェクトは、関連付けられている DkmInspectionSession オブジェクトが閉じられると自動的に閉じられます。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
Create(DkmInspectionSession, DkmLanguage, DkmClrType, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, Boolean, Object, DkmStackWalkFrame, DkmEvaluationResultFlags, DkmClrValueFlags, UInt64, DkmDataAddress, String, ReadOnlyCollection<Int32>, ReadOnlyCollection<Int32>, DkmDataItem) |
新しい DkmClrValue オブジェクト インスタンスをCreateします。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
Dereference(DkmInspectionContext) |
基になる値を取得するには、このポインター値を逆参照します。 このメソッドは、DkmClrValue が Pointer 値を表す場合にのみ使用できます。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
EvaluateDebuggerDisplayString(DkmWorkList, DkmInspectionContext, DkmClrType, String, DkmCompletionRoutine<DkmEvaluateDebuggerDisplayStringAsyncResult>) |
DebuggerDisplay 属性文字列を指定して、CLR 値のデバッガー UI に表示する文字列を取得します。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
EvaluateToString(DkmInspectionContext) |
指定された DkmClrValue で表されるオブジェクトに対して ToString オーバーライドを実行します。 値が object 型の場合、または ToString をオーバーライドしない場合、このメソッドは null を返します。 このメソッドでは、関数の評価を有効にする必要があります。 関数の評価がユーザーまたは他の理由で無効になっている場合、このメソッドは null を返します。 このメソッドは、何らかの理由で関数の評価が失敗した場合にも null を返します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
GetArrayElement(Int32[], DkmInspectionContext) |
配列要素を取得します。 このメソッドは、DkmClrValue が配列値を表す場合にのみ使用できます。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
GetDataItem<T>() |
このコンテナー インスタンスに追加された 'T' のインスタンスを取得します。 このコンテナーに 'T' が含まれていない場合、この関数は null を返します。 (継承元 DkmDataContainer) |
GetEditableValueString(DkmInspectionContext, DkmClrCustomTypeInfo) |
指定された DkmClrValue の UI に表示する編集可能な値文字列を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。 |
GetMemberValue(String, Int32, String, DkmInspectionContext) |
フィールドまたはプロパティの値を DkmClrValue として取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
GetResult(DkmWorkList, DkmClrType, DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>, String, String, DkmCompletionRoutine<DkmEvaluationAsyncResult>) |
DkmClrValue を書式設定し、DkmEvaluationResult を返します。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
GetUnderlyingString(DkmInspectionContext) |
値の基になる文字列表現を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
GetValueString(DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>) |
指定された DkmClrValue の UI に表示する値文字列を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 15 RTM (DkmApiVersion.VS15RTM) で導入されました。 |
GetValueString(DkmInspectionContext, ReadOnlyCollection<String>) |
指定された DkmClrValue の UI に表示する値文字列を取得します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
HasUnderlyingString(DkmInspectionContext) |
この値に基になる文字列表現があるかどうかを判断します。 このメソッドが true を返す場合、ユーザーは文字列ビジュアライザーを使用してデバッガーでこの値を表示できます。 GetUnderlyingString は、基になる文字列表現を返す必要があります。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
InstantiateDynamicViewProxy(DkmInspectionContext) |
IDynamicMetaObjectProvider 値の動的メンバーを反復処理するために使用するプロキシ クラスをインスタンス化します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
InstantiateProxyType(DkmInspectionContext, DkmClrType) |
関連付けられた DebuggerTypeProxy 属性を使用して、DkmClrValue のプロキシ クラスをインスタンス化します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
InstantiateResultsViewProxy(DkmInspectionContext, DkmClrType) |
IEnumerable 値の反復処理に使用するプロキシ クラスをインスタンス化します。 場所の制約: API は、Monitor コンポーネント (コンポーネント レベル < 100,000) から呼び出す必要があります。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
RemoveDataItem<T>() |
このコンテナーから 'T' のインスタンスを削除します。 通常、オブジェクトが閉じられるとデータ コンテナーが自動的に空になるので、このメソッドを呼び出す必要があります。 (継承元 DkmDataContainer) |
SetDataItem<T>(DkmDataCreationDisposition, T) |
データ コンテナーに新しい項目を配置します。 (継承元 DkmDataContainer) |
明示的なインターフェイスの実装
IDisposable.Dispose() |
追加する。 |