DkmRootVisualizedExpression.Create 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, DkmDataItem) |
创建新的 DkmRootVisualizedExpression 对象实例。 |
| Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, String, DkmDataItem) |
创建新的 DkmRootVisualizedExpression 对象实例。 |
Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, DkmDataItem)
创建新的 DkmRootVisualizedExpression 对象实例。
public:
static Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpression ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, Microsoft::VisualStudio::Debugger::Evaluation::DkmExpressionValueHome ^ ValueHome, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, System::String ^ Name, System::String ^ FullName, Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpressionFlags Flags, System::UInt32 ArrayLength, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);public static Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpression Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome ValueHome, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, string Name, string FullName, Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags Flags, uint ArrayLength, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Guid * Guid * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * string * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags * uint32 * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionPublic Shared Function Create (InspectionContext As DkmInspectionContext, VisualizerId As Guid, SourceId As Guid, StackFrame As DkmStackWalkFrame, ValueHome As DkmExpressionValueHome, Module As DkmModule, Name As String, FullName As String, Flags As DkmRootVisualizedExpressionFlags, ArrayLength As UInteger, DataItem As DkmDataItem) As DkmRootVisualizedExpression参数
- InspectionContext
- DkmInspectionContext
中要在执行检查操作时使用的选项和目标上下文。
- VisualizerId
- Guid
中将外接程序与调用该外接程序的表达式结合在一起的 Guid。 外接程序应使用本机可视化工具文件中提供的 Guid 作为筛选器。
- SourceId
- Guid
中将创建此对象和对象本身的表达式计算器结合在一起的 Guid。 通常由表达式计算器用来筛选 IDkmCustomVisualizerCallback 对其创建的 DkmVisualizedExpression 的实现。
- StackFrame
- DkmStackWalkFrame
中堆栈帧在的表达式中计算表达式。
- ValueHome
- DkmExpressionValueHome
[In，可选]值的存储位置，可以修改该值以编辑值。 对于只读值，此值应为 null，如整数常量。
- Module
- DkmModule
[In，可选]包含类型符号的模块。
- Name
- String
中到根节点的表达式的名称。 加载项可以选择使用此名称或构造自己的名称。
- FullName
- String
中直到根节点的表达式的完整名称。 加载项可以选择使用此全名，也可以构造自己的名称。 但是，如果外接程序使用不同的全名，则它必须通过表达式计算器进行分析。
中标志表达式计算器传递到描述相关值的可视化工具外接程序。 例如，如果对象是指针或引用，则会包括。
- ArrayLength
- UInt32
中弃用：不再使用。
- DataItem
- DkmDataItem
[In，可选]要添加到新的 DkmRootVisualizedExpression 实例的数据对象。 如果调用方不需要添加数据项，则传递 "null"。
返回
弄此方法调用的结果。
适用于
Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, String, DkmDataItem)
创建新的 DkmRootVisualizedExpression 对象实例。
此 API 是在 Visual Studio 14 RTM (VS14RTM) 中引入的。
public:
static Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpression ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, Microsoft::VisualStudio::Debugger::Evaluation::DkmExpressionValueHome ^ ValueHome, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, System::String ^ Name, System::String ^ FullName, Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpressionFlags Flags, System::UInt32 ArrayLength, System::String ^ Type, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);public static Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpression Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome ValueHome, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, string Name, string FullName, Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags Flags, uint ArrayLength, string Type, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Guid * Guid * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * string * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags * uint32 * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionPublic Shared Function Create (InspectionContext As DkmInspectionContext, VisualizerId As Guid, SourceId As Guid, StackFrame As DkmStackWalkFrame, ValueHome As DkmExpressionValueHome, Module As DkmModule, Name As String, FullName As String, Flags As DkmRootVisualizedExpressionFlags, ArrayLength As UInteger, Type As String, DataItem As DkmDataItem) As DkmRootVisualizedExpression参数
- InspectionContext
- DkmInspectionContext
中要在执行检查操作时使用的选项和目标上下文。
- VisualizerId
- Guid
中将外接程序与调用该外接程序的表达式结合在一起的 Guid。 外接程序应使用本机可视化工具文件中提供的 Guid 作为筛选器。
- SourceId
- Guid
中将创建此对象和对象本身的表达式计算器结合在一起的 Guid。 通常由表达式计算器用来筛选 IDkmCustomVisualizerCallback 对其创建的 DkmVisualizedExpression 的实现。
- StackFrame
- DkmStackWalkFrame
中堆栈帧在的表达式中计算表达式。
- ValueHome
- DkmExpressionValueHome
[In，可选]值的存储位置，可以修改该值以编辑值。 对于只读值，此值应为 null，如整数常量。
- Module
- DkmModule
[In，可选]包含类型符号的模块。
- Name
- String
中到根节点的表达式的名称。 加载项可以选择使用此名称或构造自己的名称。
- FullName
- String
中直到根节点的表达式的完整名称。 加载项可以选择使用此全名，也可以构造自己的名称。 但是，如果外接程序使用不同的全名，则它必须通过表达式计算器进行分析。
中标志表达式计算器传递到描述相关值的可视化工具外接程序。 例如，如果对象是指针或引用，则会包括。
- ArrayLength
- UInt32
中弃用：不再使用。
- Type
- String
[In，可选]要检查的对象的类型。 这通常是触发外接程序的 natvis 项所引用的类型。 但是，它也可以是指向类型的指针或引用，甚至是类型的基类或派生类。 外接程序不应假设此字符串中的内容，也不应尝试对其进行分析以获取有关对象的信息。 大多数外接应传递此字符串，就像它们所创建的计算结果的 "Type" 属性一样。 但是，外接程序可能会选择在将其他批注返回到 "Type" 字符串后将其返回。 除了提示要放入结果的 "类型" 字段的提示，此字符串与对象的可视化无关。 无论原始对象是指针、引用、基类型还是派生类型，所提供的 DkmExpressionValueHome 都将始终标识该对象本身的位置，而不是指向对象的指针或引用。 如果计算结果的类型对于要在其中调用可视化工具的方案不重要，则可以在此处传入空类型字符串。
- DataItem
- DkmDataItem
[In，可选]要添加到新的 DkmRootVisualizedExpression 实例的数据对象。 如果调用方不需要添加数据项，则传递 "null"。
返回
弄此方法调用的结果。