Expression.Label Methode

Definitie

Hiermee wordt een LabelTarget label gemaakt.

Overloads

Name Description
Label()

Hiermee maakt u een LabelTarget label met een ongeldigheidstype en geen naam.

Label(LabelTarget)

Hiermee maakt u een LabelExpression label zonder standaardwaarde.

Label(String)

Hiermee maakt u een LabelTarget label met een ongeldigheidstype en de opgegeven naam.

Label(Type)

Hiermee maakt u een LabelTarget label met het opgegeven type.

Label(LabelTarget, Expression)

Hiermee maakt u een LabelExpression label met de opgegeven standaardwaarde.

Label(Type, String)

Hiermee maakt u een LabelTarget label met het opgegeven type en de naam.

Label()

Hiermee maakt u een LabelTarget label met een ongeldigheidstype en geen naam.

public:
 static System::Linq::Expressions::LabelTarget ^ Label();
public static System.Linq.Expressions.LabelTarget Label();
static member Label : unit -> System.Linq.Expressions.LabelTarget
Public Shared Function Label () As LabelTarget

Retouren

Het nieuwe LabelTarget.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een expressie maakt die een LabelTarget object bevat.

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

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

// This block contains a GotoExpression that represents a return statement with no value.
// 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("Return")),
        Expression.Return(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:
//
// Return

// "Other Work" is not printed because
// the Return expression transfers execution from Expression.Return(returnTarget)
// to Expression.Label(returnTarget).
' Add the following directive to the file:
' Imports System.Linq.Expressions  

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

' This block contains a GotoExpression that represents a return statement with no value.
' 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("Return")),
          Expression.Return(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:
'
' Return

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

Van toepassing op

Label(LabelTarget)

Hiermee maakt u een LabelExpression label zonder standaardwaarde.

public:
 static System::Linq::Expressions::LabelExpression ^ Label(System::Linq::Expressions::LabelTarget ^ target);
public static System.Linq.Expressions.LabelExpression Label(System.Linq.Expressions.LabelTarget target);
static member Label : System.Linq.Expressions.LabelTarget -> System.Linq.Expressions.LabelExpression
Public Shared Function Label (target As LabelTarget) As LabelExpression

Parameters

target
LabelTarget

De LabelTarget waaraan dit LabelExpression is gekoppeld.

Retouren

Een LabelExpression zonder standaardwaarde.

Van toepassing op

Label(String)

Hiermee maakt u een LabelTarget label met een ongeldigheidstype en de opgegeven naam.

public:
 static System::Linq::Expressions::LabelTarget ^ Label(System::String ^ name);
public static System.Linq.Expressions.LabelTarget Label(string name);
static member Label : string -> System.Linq.Expressions.LabelTarget
Public Shared Function Label (name As String) As LabelTarget

Parameters

name
String

De naam van het label.

Retouren

Het nieuwe LabelTarget.

Van toepassing op

Label(Type)

Hiermee maakt u een LabelTarget label met het opgegeven type.

public:
 static System::Linq::Expressions::LabelTarget ^ Label(Type ^ type);
public static System.Linq.Expressions.LabelTarget Label(Type type);
static member Label : Type -> System.Linq.Expressions.LabelTarget
Public Shared Function Label (type As Type) As LabelTarget

Parameters

type
Type

Het type waarde dat wordt doorgegeven bij het springen naar het label.

Retouren

Het nieuwe LabelTarget.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een LabelTarget object gebruikt in een lusexpressie.

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

// Creating a parameter expression.
ParameterExpression value = Expression.Parameter(typeof(int), "value");

// Creating an expression to hold a local variable.
ParameterExpression result = Expression.Parameter(typeof(int), "result");

// Creating a label to jump to from a loop.
LabelTarget label = Expression.Label(typeof(int));

// Creating a method body.
BlockExpression block = Expression.Block(
    new[] { result },
    Expression.Assign(result, Expression.Constant(1)),
        Expression.Loop(
           Expression.IfThenElse(
               Expression.GreaterThan(value, Expression.Constant(1)),
               Expression.MultiplyAssign(result,
                   Expression.PostDecrementAssign(value)),
               Expression.Break(label, result)
           ),
       label
    )
);

// Compile and run an expression tree.
int factorial = Expression.Lambda<Func<int, int>>(block, value).Compile()(5);

Console.WriteLine(factorial);

// This code example produces the following output:
//
// 120
' Add the following directive to the file:
' Imports System.Linq.Expressions  

' Creating a parameter expression.
Dim value As ParameterExpression =
    Expression.Parameter(GetType(Integer), "value")

' Creating an expression to hold a local variable. 
Dim result As ParameterExpression =
    Expression.Parameter(GetType(Integer), "result")

' Creating a label to jump to from a loop.
Dim label As LabelTarget = Expression.Label(GetType(Integer))

' Creating a method body.
Dim block As BlockExpression = Expression.Block(
    New ParameterExpression() {result},
    Expression.Assign(result, Expression.Constant(1)),
    Expression.Loop(
        Expression.IfThenElse(
            Expression.GreaterThan(value, Expression.Constant(1)),
            Expression.MultiplyAssign(result,
                Expression.PostDecrementAssign(value)),
            Expression.Break(label, result)
        ),
        label
    )
)

' Compile an expression tree and return a delegate.
Dim factorial As Integer =
    Expression.Lambda(Of Func(Of Integer, Integer))(block, value).Compile()(5)

Console.WriteLine(factorial)

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

Van toepassing op

Label(LabelTarget, Expression)

Hiermee maakt u een LabelExpression label met de opgegeven standaardwaarde.

public:
 static System::Linq::Expressions::LabelExpression ^ Label(System::Linq::Expressions::LabelTarget ^ target, System::Linq::Expressions::Expression ^ defaultValue);
public static System.Linq.Expressions.LabelExpression Label(System.Linq.Expressions.LabelTarget target, System.Linq.Expressions.Expression defaultValue);
static member Label : System.Linq.Expressions.LabelTarget * System.Linq.Expressions.Expression -> System.Linq.Expressions.LabelExpression
Public Shared Function Label (target As LabelTarget, defaultValue As Expression) As LabelExpression

Parameters

target
LabelTarget

De LabelTarget waaraan dit LabelExpression is gekoppeld.

defaultValue
Expression

De waarde hiervan LabelExpression wanneer het label wordt bereikt via een normale controlestroom.

Retouren

Een LabelExpression met de opgegeven standaardwaarde.

Van toepassing op

Label(Type, String)

Hiermee maakt u een LabelTarget label met het opgegeven type en de naam.

public:
 static System::Linq::Expressions::LabelTarget ^ Label(Type ^ type, System::String ^ name);
public static System.Linq.Expressions.LabelTarget Label(Type type, string name);
static member Label : Type * string -> System.Linq.Expressions.LabelTarget
Public Shared Function Label (type As Type, name As String) As LabelTarget

Parameters

type
Type

Het type waarde dat wordt doorgegeven bij het springen naar het label.

name
String

De naam van het label.

Retouren

Het nieuwe LabelTarget.

Van toepassing op