DkmClrValue.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
Create新的 DkmClrValue 对象实例。
位置约束:必须从监视组件 (组件级别 < 100,000) 调用 API。
此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引入的。
public:
static Microsoft::VisualStudio::Debugger::Evaluation::ClrCompilation::DkmClrValue ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionSession ^ InspectionSession, Microsoft::VisualStudio::Debugger::Evaluation::DkmLanguage ^ Language, Microsoft::VisualStudio::Debugger::Clr::DkmClrType ^ Type, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultCategory Category, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultAccessType Access, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultStorageType StorageType, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, System::Object ^ HostObjectValue, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultFlags EvalFlags, Microsoft::VisualStudio::Debugger::Evaluation::DkmClrValueFlags ValueFlags, System::UInt64 NativeComPointer, Microsoft::VisualStudio::Debugger::Evaluation::DkmDataAddress ^ Address, System::String ^ Alias, System::Collections::ObjectModel::ReadOnlyCollection<int> ^ ArrayDimensions, System::Collections::ObjectModel::ReadOnlyCollection<int> ^ ArrayLowerBounds, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue Create(Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage Language, Microsoft.VisualStudio.Debugger.Clr.DkmClrType Type, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType Access, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType StorageType, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, object HostObjectValue, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags EvalFlags, Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags ValueFlags, ulong NativeComPointer, Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress Address, string Alias, System.Collections.ObjectModel.ReadOnlyCollection<int> ArrayDimensions, System.Collections.ObjectModel.ReadOnlyCollection<int> ArrayLowerBounds, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue Create(Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage Language, Microsoft.VisualStudio.Debugger.Clr.DkmClrType? Type, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType Access, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType StorageType, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, object? HostObjectValue, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags EvalFlags, Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags ValueFlags, ulong NativeComPointer, Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress? Address, string? Alias, System.Collections.ObjectModel.ReadOnlyCollection<int>? ArrayDimensions, System.Collections.ObjectModel.ReadOnlyCollection<int>? ArrayLowerBounds, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession * Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage * Microsoft.VisualStudio.Debugger.Clr.DkmClrType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags * bool * obj * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags * Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags * uint64 * Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress * string * System.Collections.ObjectModel.ReadOnlyCollection<int> * System.Collections.ObjectModel.ReadOnlyCollection<int> * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue
Public Shared Function Create (InspectionSession As DkmInspectionSession, Language As DkmLanguage, Type As DkmClrType, Category As DkmEvaluationResultCategory, Access As DkmEvaluationResultAccessType, StorageType As DkmEvaluationResultStorageType, TypeModifierFlags As DkmEvaluationResultTypeModifierFlags, IsNull As Boolean, HostObjectValue As Object, StackFrame As DkmStackWalkFrame, EvalFlags As DkmEvaluationResultFlags, ValueFlags As DkmClrValueFlags, NativeComPointer As ULong, Address As DkmDataAddress, Alias As String, ArrayDimensions As ReadOnlyCollection(Of Integer), ArrayLowerBounds As ReadOnlyCollection(Of Integer), DataItem As DkmDataItem) As DkmClrValue
参数
- InspectionSession
- DkmInspectionSession
[In]InspectionSession 允许检查目标进程中数据的各种组件存储具有相同生存期的专用数据。 当用户尝试继续该过程时,将关闭检查会话。
- Language
- DkmLanguage
[In]使用的语言。
- Type
- DkmClrType
[In,Optional]此节点的运行时类型。 例如,System.String。 当值无效且无法确定类型时,此值为 null。
- Category
- DkmEvaluationResultCategory
[In]类别 (例如:数据、方法等) 此评估结果。
[In]访问控制级别 (评估结果) 公共、专用等。
- StorageType
- DkmEvaluationResultStorageType
[In]存储类型 (例如:评估结果的静态) 。
- TypeModifierFlags
- DkmEvaluationResultTypeModifierFlags
[In]类型修饰符标志 (示例:计算结果的 const) 。
- IsNull
- Boolean
[In]如此 如果值为 null (或没有值) 。
- HostObjectValue
- Object
[In,Optional]如果 DkmClrValue 是可在调试器进程中表示的值,则为此节点的值。 如果 DkmClrValue 为复杂类型,则此值将为 null。 当基础值为字符串时,在本机代码中使用时,请注意:如果在本机代码中使用此字段,VARIANT 结构可能是 BSTR 或 IUnknown,应查询 IDkmManagedStringRef。 如果要在本机代码中创建此字段,请使用 BSTR 的 VARIANT。
- StackFrame
- DkmStackWalkFrame
[In]用作解释表达式的检查帧的堆栈帧。
- EvalFlags
- DkmEvaluationResultFlags
[In]描述创建此 DkmClrValue 的评估结果的标志。
- ValueFlags
- DkmClrValueFlags
[In]描述此值的标志。
- NativeComPointer
- UInt64
[In]如果此值为 RCW,则为指向本机 COM 对象的接口指针。
- Address
- DkmDataAddress
[In,Optional]如果结果是地址 (即在标志) 中设置地址标志,则指定支持值的位置。 当评估结果用作内存窗口或反汇编窗口的输入时,将使用此函数。 如果它是指令地址,则必须设置 CPUInstruction 地址。
- Alias
- String
[In,Optional]此值的别名。 如果尚未为对象分配别名,则此值将为 null。
- ArrayDimensions
- ReadOnlyCollection<Int32>
[In,Optional]数组的维度。 仅当此 DkmClrValue 是数组值时,此值才有效。
- ArrayLowerBounds
- ReadOnlyCollection<Int32>
[In,Optional]数组的下限。 仅当此 DkmClrValue 是数组值时,此值才有效。
- DataItem
- DkmDataItem
[In,Optional]要添加到新 DkmClrValue 实例的数据对象。 如果调用方不需要添加数据项,则传递“null”。
返回
[Out]此方法调用的结果。