Debugger.GetExpression Method

Article
2013-02-04

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

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

Syntax

'Declaration
Function GetExpression ( _
    ExpressionText As String, _
    UseAutoExpandRules As Boolean, _
    Timeout As Integer _
) As Expression

Expression GetExpression(
    string ExpressionText,
    bool UseAutoExpandRules,
    int Timeout
)

Expression^ GetExpression(
    [InAttribute] String^ ExpressionText, 
    [InAttribute] bool UseAutoExpandRules, 
    [InAttribute] int Timeout
)

abstract GetExpression : 
        ExpressionText:string * 
        UseAutoExpandRules:bool * 
        Timeout:int -> Expression

function GetExpression(
    ExpressionText : String, 
    UseAutoExpandRules : boolean, 
    Timeout : int
) : Expression

Parameters

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

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

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

Return Value

Type: EnvDTE.Expression
A Expression object.

Remarks

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

Examples

The following example demonstrates how to use M:EnvDTE.Debugger.GetExpression(System.String,System.Boolean,System.Int32) property.

Sub DisplayExpression(Optional ByVal str As String = "")
    Dim expr As Expression
    expr = DTE.Debugger.GetExpression(str)

    If (expr.IsValidValue) Then
        MsgBox(expr.Name + " = " + expr.Value)
    Else
        MsgBox("Expression was not valid")
    End If

End Sub

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via