Поделиться через


Expression.Label Метод

Определение

Создает объект LabelTarget, представляющий метку.

Перегрузки

Label()

Создает объект LabelTarget, представляющий метку с типом void, не имеющую имени.

Label(LabelTarget)

Создает объект LabelExpression, представляющий метку без значения по умолчанию.

Label(String)

Создает объектLabelTarget, представляющий метку с типом void и заданным именем.

Label(Type)

Создает объект LabelTarget, представляющий метку с заданным типом.

Label(LabelTarget, Expression)

Создает выражение LabelExpression, представляющее метку с заданным значением по умолчанию.

Label(Type, String)

Создает объект LabelTarget, представляющий метку с заданными типом и именем.

Label()

Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs

Создает объект LabelTarget, представляющий метку с типом void, не имеющую имени.

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

Возвращаемое значение

Новый объект LabelTarget.

Примеры

В следующем примере показано, как создать выражение, содержащее LabelTarget объект .

// 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).

Применяется к

Label(LabelTarget)

Исходный код:
LabelExpression.cs
Исходный код:
LabelExpression.cs
Исходный код:
LabelExpression.cs

Создает объект LabelExpression, представляющий метку без значения по умолчанию.

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

Параметры

target
LabelTarget

Объект LabelTarget, с которым будет связано данное выражение LabelExpression.

Возвращаемое значение

LabelExpression без значения по умолчанию.

Применяется к

Label(String)

Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs

Создает объектLabelTarget, представляющий метку с типом void и заданным именем.

public:
 static System::Linq::Expressions::LabelTarget ^ Label(System::String ^ name);
public static System.Linq.Expressions.LabelTarget Label (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

Параметры

name
String

Имя метки.

Возвращаемое значение

Новый объект LabelTarget.

Применяется к

Label(Type)

Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs

Создает объект LabelTarget, представляющий метку с заданным типом.

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

Параметры

type
Type

Тип значения, которое передается при переходе к метке.

Возвращаемое значение

Новый объект LabelTarget.

Примеры

В следующем примере показано, как использовать LabelTarget объект в выражении цикла.

// 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

Применяется к

Label(LabelTarget, Expression)

Исходный код:
LabelExpression.cs
Исходный код:
LabelExpression.cs
Исходный код:
LabelExpression.cs

Создает выражение LabelExpression, представляющее метку с заданным значением по умолчанию.

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);
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

Параметры

target
LabelTarget

Объект LabelTarget, с которым будет связано данное выражение LabelExpression.

defaultValue
Expression

Значение данного выражения LabelExpression после достижения метки через стандартный поток управления.

Возвращаемое значение

LabelExpression с заданным значением по умолчанию.

Применяется к

Label(Type, String)

Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs
Исходный код:
LabelTarget.cs

Создает объект LabelTarget, представляющий метку с заданными типом и именем.

public:
 static System::Linq::Expressions::LabelTarget ^ Label(Type ^ type, System::String ^ name);
public static System.Linq.Expressions.LabelTarget Label (Type type, 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

Параметры

type
Type

Тип значения, которое передается при переходе к метке.

name
String

Имя метки.

Возвращаемое значение

Новый объект LabelTarget.

Применяется к