Expression.Goto Method

Reference

Definition

Namespace:: System.Linq.Expressions

Assemblies:: System.Core.dll, System.Linq.Expressions.dll

Assemblies:: netstandard.dll, System.Linq.Expressions.dll

Assembly:: System.Linq.Expressions.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Creates a GotoExpression representing a "go to" statement.

Overloads

Goto(LabelTarget, Expression, Type)	Creates a GotoExpression representing a "go to" statement with the specified type. The value passed to the label upon jumping can be specified.
Goto(LabelTarget, Type)	Creates a GotoExpression representing a "go to" statement with the specified type.
Goto(LabelTarget)	Creates a GotoExpression representing a "go to" statement.
Goto(LabelTarget, Expression)	Creates a GotoExpression representing a "go to" statement. The value passed to the label upon jumping can be specified.

Goto(LabelTarget, Expression, Type)

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Creates a GotoExpression representing a "go to" statement with the specified type. The value passed to the label upon jumping can be specified.

public:
 static System::Linq::Expressions::GotoExpression ^ Goto(System::Linq::Expressions::LabelTarget ^ target, System::Linq::Expressions::Expression ^ value, Type ^ type);

public static System.Linq.Expressions.GotoExpression Goto(System.Linq.Expressions.LabelTarget target, System.Linq.Expressions.Expression value, Type type);

public static System.Linq.Expressions.GotoExpression Goto(System.Linq.Expressions.LabelTarget target, System.Linq.Expressions.Expression? value, Type type);

static member Goto : System.Linq.Expressions.LabelTarget * System.Linq.Expressions.Expression * Type -> System.Linq.Expressions.GotoExpression

Public Shared Function Goto (target As LabelTarget, value As Expression, type As Type) As GotoExpression

Parameters

target: LabelTarget

The LabelTarget that the GotoExpression will jump to.

value: Expression

The value that will be passed to the associated label upon jumping.

type: Type

An Type to set the Type property equal to.

Returns

GotoExpression

A GotoExpression with Kind equal to Goto, the Target property set to target, the Type property set to type, and value to be passed to the target label upon jumping.

Applies to

.NET 10 and other versions

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Goto(LabelTarget, Type)

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Creates a GotoExpression representing a "go to" statement with the specified type.

public:
 static System::Linq::Expressions::GotoExpression ^ Goto(System::Linq::Expressions::LabelTarget ^ target, Type ^ type);

public static System.Linq.Expressions.GotoExpression Goto(System.Linq.Expressions.LabelTarget target, Type type);

static member Goto : System.Linq.Expressions.LabelTarget * Type -> System.Linq.Expressions.GotoExpression

Public Shared Function Goto (target As LabelTarget, type As Type) As GotoExpression

Parameters

target: LabelTarget

The LabelTarget that the GotoExpression will jump to.

type: Type

An Type to set the Type property equal to.

Returns

GotoExpression

A GotoExpression with Kind equal to Goto, the Target property set to the specified value, the Type property set to type, and a null value to be passed to the target label upon jumping.

Applies to

.NET 10 and other versions

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Goto(LabelTarget)

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Creates a GotoExpression representing a "go to" statement.

public:
 static System::Linq::Expressions::GotoExpression ^ Goto(System::Linq::Expressions::LabelTarget ^ target);

public static System.Linq.Expressions.GotoExpression Goto(System.Linq.Expressions.LabelTarget target);

static member Goto : System.Linq.Expressions.LabelTarget -> System.Linq.Expressions.GotoExpression

Public Shared Function Goto (target As LabelTarget) As GotoExpression

Parameters

target: LabelTarget

The LabelTarget that the GotoExpression will jump to.

Returns

GotoExpression

A GotoExpression with Kind equal to Goto, the Target property set to the specified value, and a null value to be passed to the target label upon jumping.

Examples

The following example demonstrates how to create an expression that contains a GotoExpression object.

// Add the following directive to your file:
// using System.Linq.Expressions;

// A label expression of the void type that is the target for the GotoExpression.
LabelTarget returnTarget = Expression.Label();

// This block contains a GotoExpression.
// It transfers execution to a label expression that is initialized with the same LabelTarget as the GotoExpression.
// The types of the GotoExpression, label expression, and LabelTarget must match.
BlockExpression blockExpr =
    Expression.Block(
        Expression.Call(typeof(Console).GetMethod("WriteLine", new Type[] { typeof(string) }), Expression.Constant("GoTo")),
        Expression.Goto(returnTarget),
        Expression.Call(typeof(Console).GetMethod("WriteLine", new Type[] { typeof(string) }), Expression.Constant("Other Work")),
        Expression.Label(returnTarget)
    );

// The following statement first creates an expression tree,
// then compiles it, and then runs it.
Expression.Lambda<Action>(blockExpr).Compile()();

// This code example produces the following output:
//
// GoTo

// "Other Work" is not printed because
// the GoTo expression transfers execution from Expression.GoTo(returnTarget)
// to Expression.Label(returnTarget).

' Add the following directive to your file:
' Imports System.Linq.Expressions  

' A label expression of the void type that is the target for the GoToExpression.
Dim returnTarget As LabelTarget = Expression.Label()

' This block contains a GotoExpression.
' It transfers execution to a label expression that is initialized with the same LabelTarget as the GotoExpression.
' The types of the GotoExpression, label expression, and LabelTarget must match.
Dim blockExpr As BlockExpression =
      Expression.Block(
          Expression.Call(GetType(Console).GetMethod("WriteLine", New Type() {GetType(String)}), Expression.Constant("GoTo")),
          Expression.Goto(returnTarget),
          Expression.Call(GetType(Console).GetMethod("WriteLine", New Type() {GetType(String)}), Expression.Constant("Other Work")),
          Expression.Label(returnTarget)
      )

' The following statement first creates an expression tree,
' then compiles it, and then runs it.
Expression.Lambda(Of Action)(blockExpr).Compile()()

' This code example produces the following output:
'
' GoTo

' "Other Work" is not printed because 
' the Return expression transfers execution from Expression.GoTo(returnTarget)
' to Expression.Label(returnTarget).

Applies to

.NET 10 and other versions

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Goto(LabelTarget, Expression)

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Source:: GotoExpression.cs

Creates a GotoExpression representing a "go to" statement. The value passed to the label upon jumping can be specified.

public:
 static System::Linq::Expressions::GotoExpression ^ Goto(System::Linq::Expressions::LabelTarget ^ target, System::Linq::Expressions::Expression ^ value);

public static System.Linq.Expressions.GotoExpression Goto(System.Linq.Expressions.LabelTarget target, System.Linq.Expressions.Expression value);

public static System.Linq.Expressions.GotoExpression Goto(System.Linq.Expressions.LabelTarget target, System.Linq.Expressions.Expression? value);

static member Goto : System.Linq.Expressions.LabelTarget * System.Linq.Expressions.Expression -> System.Linq.Expressions.GotoExpression

Public Shared Function Goto (target As LabelTarget, value As Expression) As GotoExpression

Parameters

target: LabelTarget

The LabelTarget that the GotoExpression will jump to.

value: Expression

The value that will be passed to the associated label upon jumping.

Returns

GotoExpression

A GotoExpression with Kind equal to Goto, the Target property set to target, and value to be passed to the target label upon jumping.

Applies to

.NET 10 and other versions

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Share via

Expression.Goto Method

Definition

Overloads

Goto(LabelTarget, Expression, Type)

Parameters

Returns

Applies to

Goto(LabelTarget, Type)

Parameters

Returns

Applies to

Goto(LabelTarget)

Parameters

Returns

Examples

Applies to

Goto(LabelTarget, Expression)

Parameters

Returns

Applies to

Additional resources