Expression.Label Метод

Ссылка

Определение

Пространство имен:: System.Linq.Expressions

Сборка:: System.Linq.Expressions.dll

Сборка:: System.Core.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Создает объект 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.

Примеры

В следующем примере показано, как создать выражение, содержащее 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

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

Новый объект 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.

Примеры

В следующем примере показано, как использовать 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

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

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

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

Expression.Label Метод

Определение

Перегрузки

Label()

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

Примеры

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

Label(LabelTarget)

Параметры

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

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

Label(String)

Параметры

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

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

Label(Type)

Параметры

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

Примеры

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

Label(LabelTarget, Expression)

Параметры

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

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

Label(Type, String)

Параметры

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

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

Обратная связь

Дополнительные ресурсы