Debugger5::GetExpression3 Method (String^, StackFrame^, Boolean, Boolean, Boolean, Int32)

Visual Studio 2015

Evaluates an expression, similar to M:EnvDTE90.Debugger2.GetExpression(System.String,System.Boolean,System.Boolean,System.Int32). However, this method allows the caller to specify the stack frame that the evaluation will occur on. It also allows the caller to specify whether automatic evaluation of properties and implicit function calls should occur.

Namespace: EnvDTE100
Assembly: EnvDTE100 (in EnvDTE100.dll)

Syntax

C++

Expression^ GetExpression3(
	String^ ExpressionText,
	StackFrame^ StackFrame,
	bool UseAutoExpandRules = true,
	bool TreatAsStatement = true,
	bool AllowAutoFuncEval = true,
	int Timeout = -1
)

Parameters

ExpressionText: Type: System::String^
The expression text to be evaluated.

StackFrame: Type: EnvDTE::StackFrame^
The stack frame where the expression is to be evaluated. This stack frame can be in any thread of any process that is currently being debugged, if and only if the process is in break mode.

UseAutoExpandRules: Type: System::Boolean
true if the auto-expand rules should be used; otherwise, false.

TreatAsStatement: Type: System::Boolean
true if the expression text should be treated as a single statement; otherwise, false.

AllowAutoFuncEval: Type: System::Boolean
true if automatic evaluation of properties and implicit function calls should be performed; otherwise, false.

Timeout: Type: System::Int32
The timeout period in milliseconds.

Return Value

Type: EnvDTE::Expression^

An Expression.

Implements

Debugger4::GetExpression3(String^, StackFrame^, Boolean, Boolean, Boolean, Int32)

Remarks

GetExpression3 evaluates an expression based on the specified stack frame. If the expression can be parsed but not evaluated, an object is returned but will not contain a valid value.