DkmIntermediateEvaluationResult.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Evaluation

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Overloads

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmDataItem)	Create a new DkmIntermediateEvaluationResult object instance. This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmEvaluationResultCategory, DkmDataItem)	Create a new DkmIntermediateEvaluationResult object instance. This API was introduced in Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1).
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataItem)	Create a new DkmIntermediateEvaluationResult object instance. This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmDataItem)

Create a new DkmIntermediateEvaluationResult object instance.

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::DkmIntermediateEvaluationResult ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, System::String ^ Name, System::String ^ FullName, System::String ^ Expression, Microsoft::VisualStudio::Debugger::Evaluation::DkmLanguage ^ IntermediateLanguage, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ TargetRuntime, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.Evaluation.DkmIntermediateEvaluationResult Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, string Name, string? FullName, string Expression, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage IntermediateLanguage, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance TargetRuntime, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * string * string * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage * Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.DkmIntermediateEvaluationResult

Public Shared Function Create (InspectionContext As DkmInspectionContext, StackFrame As DkmStackWalkFrame, Name As String, FullName As String, Expression As String, IntermediateLanguage As DkmLanguage, TargetRuntime As DkmRuntimeInstance, DataItem As DkmDataItem) As DkmIntermediateEvaluationResult

Parameters

InspectionContext

DkmInspectionContext

[In] Inspection context used to create this evaluation result.

StackFrame

DkmStackWalkFrame

[In] The stack frame this expression result was created on.

Name

String

[In] The name of the expression this result applies to.

FullName

String

[In,Optional] The full name of the expression this result applies to. This value is used to allow child elements to be added to the watch window (Add Watch from the context menu), and to refresh parts of the evaluation tree. As an example of how FullName differs from name, the name of the 0th element of an array in C++ is '[0]' while the full name would by 'myArrayVariable[0]'. For Visual Studio 14 and later it's possible to calculate the full name later if needed. To do this, the expression evaluator should create the DkmEvaluationResult with a null full name and implement IDkmFullNameProvider. Concord will then call IDkmFullNameProvider.CalculateFullName to get the full name when needed in the UI.

Expression

String

[In] Expression that should be evaluated by a different Expression Evaluator than the one that generated the DkmIntermediateResult.

IntermediateLanguage

DkmLanguage

[In] The language of Expression. This is different from DkmEvaluationResult->Language(), which specifies the language of the initial evaluation. IntermediateLanguage specifies the language of the re-evaluation.

TargetRuntime

DkmRuntimeInstance

[In] The runtime of the Expression Evaluator that would consume the intermediate result and produce a final result.

DataItem

DkmDataItem

[In,Optional] Data object to add to the new DkmIntermediateEvaluationResult instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmIntermediateEvaluationResult

[Out] Result of this method call.

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmEvaluationResultCategory, DkmDataItem)

Create a new DkmIntermediateEvaluationResult object instance.

This API was introduced in Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1).

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::DkmIntermediateEvaluationResult ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, System::String ^ Name, System::String ^ FullName, System::String ^ Expression, Microsoft::VisualStudio::Debugger::Evaluation::DkmLanguage ^ IntermediateLanguage, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ TargetRuntime, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultCategory Category, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.Evaluation.DkmIntermediateEvaluationResult Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, string Name, string? FullName, string Expression, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage IntermediateLanguage, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance TargetRuntime, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * string * string * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage * Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.DkmIntermediateEvaluationResult

Public Shared Function Create (InspectionContext As DkmInspectionContext, StackFrame As DkmStackWalkFrame, Name As String, FullName As String, Expression As String, IntermediateLanguage As DkmLanguage, TargetRuntime As DkmRuntimeInstance, Category As DkmEvaluationResultCategory, DataItem As DkmDataItem) As DkmIntermediateEvaluationResult

Parameters

InspectionContext

DkmInspectionContext

[In] Inspection context used to create this evaluation result.

StackFrame

DkmStackWalkFrame

[In] The stack frame this expression result was created on.

Name

String

[In] The name of the expression this result applies to.

FullName

String

[In,Optional] The full name of the expression this result applies to. This value is used to allow child elements to be added to the watch window (Add Watch from the context menu), and to refresh parts of the evaluation tree. As an example of how FullName differs from name, the name of the 0th element of an array in C++ is '[0]' while the full name would by 'myArrayVariable[0]'. For Visual Studio 14 and later it's possible to calculate the full name later if needed. To do this, the expression evaluator should create the DkmEvaluationResult with a null full name and implement IDkmFullNameProvider. Concord will then call IDkmFullNameProvider.CalculateFullName to get the full name when needed in the UI.

Expression

String

[In] Expression that should be evaluated by a different Expression Evaluator than the one that generated the DkmIntermediateResult.

IntermediateLanguage

DkmLanguage

[In] The language of Expression. This is different from DkmEvaluationResult->Language(), which specifies the language of the initial evaluation. IntermediateLanguage specifies the language of the re-evaluation.

TargetRuntime

DkmRuntimeInstance

[In] The runtime of the Expression Evaluator that would consume the intermediate result and produce a final result.

Category

DkmEvaluationResultCategory

[In] Category of the evaluation result. This overrides the DkmEvaluationResultCategory of the final evaluation result. Use DkmEvaluationResultCategory::Other to defer to that of the final evaluation result.

DataItem

DkmDataItem

[In,Optional] Data object to add to the new DkmIntermediateEvaluationResult instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmIntermediateEvaluationResult

[Out] Result of this method call.

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataItem)

Create a new DkmIntermediateEvaluationResult object instance.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::DkmIntermediateEvaluationResult ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, System::String ^ Name, System::String ^ FullName, System::String ^ Expression, Microsoft::VisualStudio::Debugger::Evaluation::DkmLanguage ^ IntermediateLanguage, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ TargetRuntime, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultCategory Category, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultAccessType Access, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultStorageType Storage, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultTypeModifierFlags TypeModifierFlags, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.Evaluation.DkmIntermediateEvaluationResult Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, string Name, string? FullName, string Expression, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage IntermediateLanguage, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance TargetRuntime, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType Access, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType Storage, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags TypeModifierFlags, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * string * string * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage * Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.DkmIntermediateEvaluationResult

Public Shared Function Create (InspectionContext As DkmInspectionContext, StackFrame As DkmStackWalkFrame, Name As String, FullName As String, Expression As String, IntermediateLanguage As DkmLanguage, TargetRuntime As DkmRuntimeInstance, Category As DkmEvaluationResultCategory, Access As DkmEvaluationResultAccessType, Storage As DkmEvaluationResultStorageType, TypeModifierFlags As DkmEvaluationResultTypeModifierFlags, DataItem As DkmDataItem) As DkmIntermediateEvaluationResult

Parameters

InspectionContext

DkmInspectionContext

[In] Inspection context used to create this evaluation result.

StackFrame

DkmStackWalkFrame

[In] The stack frame this expression result was created on.

Name

String

[In] The name of the expression this result applies to.

FullName

String

[In,Optional] The full name of the expression this result applies to. This value is used to allow child elements to be added to the watch window (Add Watch from the context menu), and to refresh parts of the evaluation tree. As an example of how FullName differs from name, the name of the 0th element of an array in C++ is '[0]' while the full name would by 'myArrayVariable[0]'. For Visual Studio 14 and later it's possible to calculate the full name later if needed. To do this, the expression evaluator should create the DkmEvaluationResult with a null full name and implement IDkmFullNameProvider. Concord will then call IDkmFullNameProvider.CalculateFullName to get the full name when needed in the UI.

Expression

String

[In] Expression that should be evaluated by a different Expression Evaluator than the one that generated the DkmIntermediateResult.

IntermediateLanguage

DkmLanguage

[In] The language of Expression. This is different from DkmEvaluationResult->Language(), which specifies the language of the initial evaluation. IntermediateLanguage specifies the language of the re-evaluation.

TargetRuntime

DkmRuntimeInstance

[In] The runtime of the Expression Evaluator that would consume the intermediate result and produce a final result.

Category

DkmEvaluationResultCategory

[In] Category of the evaluation result. This overrides the DkmEvaluationResultCategory of the final evaluation result. Use DkmEvaluationResultCategory::Other to defer to that of the final evaluation result.

Access

DkmEvaluationResultAccessType

[In] Access level of the evaluation result. This overrides the DkmEvaluationResultAccessType of the final evaluation result. Use DkmEvaluationResultAccessType::None to defer to that of the final evaluation result.

Storage

DkmEvaluationResultStorageType

[In] storage type of the evaluation result. This overrides the DkmEvaluationResultStorageType of the final evaluation result. Use DkmEvaluationResultStorageType::None to defer to that of the final evaluation result.

TypeModifierFlags

DkmEvaluationResultTypeModifierFlags

[In] type modifier flags of the evaluation result. This overrides the DkmEvaluationResultTypeModifierFlags of the final evaluation result. Use DkmEvaluationResultTypeModifierFlags::None to defer to that of the final evaluation result.

DataItem

DkmDataItem

[In,Optional] Data object to add to the new DkmIntermediateEvaluationResult instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmIntermediateEvaluationResult

[Out] Result of this method call.