Expression.Label Método

Referência

Definição

Namespace:: System.Linq.Expressions

Assembly:: System.Linq.Expressions.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um LabelTarget que representa um demonstrativo de retorno.

Sobrecargas

Label()	Cria um LabelTarget que representa um rótulo com um tipo void e sem nenhum nome.
Label(LabelTarget)	Cria um LabelExpression que representa um rótulo com um valor padrão.
Label(String)	Cria um LabelTarget que representa um rótulo com um tipo void e o nome fornecido.
Label(Type)	Cria um LabelTarget que representa um rótulo com o tipo fornecido.
Label(LabelTarget, Expression)	Cria um LabelExpression que representa um rótulo com o valor padrão fornecido.
Label(Type, String)	Cria um LabelTarget que representa um rótulo com o tipo e nome fornecidos.

Label()

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Cria um LabelTarget que representa um rótulo com um tipo void e sem nenhum nome.

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

Retornos

LabelTarget

O novo LabelTarget.

Exemplos

O exemplo a seguir demonstra como criar uma expressão que contém um LabelTarget objeto .

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

Aplica-se a

Label(LabelTarget)

Origem:: LabelExpression.cs

Origem:: LabelExpression.cs

Origem:: LabelExpression.cs

Cria um LabelExpression que representa um rótulo com um valor padrão.

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

Parâmetros

target: LabelTarget

O LabelTarget ao qual esse LabelExpression será associado.

Retornos

LabelExpression

Um LabelExpression sem um valor padrão.

Aplica-se a

Label(String)

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Cria um LabelTarget que representa um rótulo com um tipo void e o nome fornecido.

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

Parâmetros

name: String

O nome do rótulo.

Retornos

LabelTarget

O novo LabelTarget.

Aplica-se a

Label(Type)

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Cria um LabelTarget que representa um rótulo com o tipo fornecido.

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

Parâmetros

type: Type

O tipo de valor que é passado ao saltar para o rótulo.

Retornos

LabelTarget

O novo LabelTarget.

Exemplos

O exemplo a seguir demonstra como usar um LabelTarget objeto em uma expressão de loop.

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

Aplica-se a

Label(LabelTarget, Expression)

Origem:: LabelExpression.cs

Origem:: LabelExpression.cs

Origem:: LabelExpression.cs

Cria um LabelExpression que representa um rótulo com o valor padrão fornecido.

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

Parâmetros

target: LabelTarget

O LabelTarget ao qual esse LabelExpression será associado.

defaultValue: Expression

O valor desse LabelExpression quando o rótulo é acessado por meio de fluxo de controle normal.

Retornos

LabelExpression

Um LabelExpression com o valor padrão fornecido.

Aplica-se a

Label(Type, String)

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Origem:: LabelTarget.cs

Cria um LabelTarget que representa um rótulo com o tipo e nome fornecidos.

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

Parâmetros

type: Type

O tipo de valor que é passado ao saltar para o rótulo.

name: String

O nome do rótulo.

Retornos

LabelTarget

O novo LabelTarget.

Aplica-se a

Compartilhar via

Expression.Label Método

Definição

Sobrecargas

Label()

Retornos

Exemplos

Aplica-se a

Label(LabelTarget)

Parâmetros

Retornos

Aplica-se a

Label(String)

Parâmetros

Retornos

Aplica-se a

Label(Type)

Parâmetros

Retornos

Exemplos

Aplica-se a

Label(LabelTarget, Expression)

Parâmetros

Retornos

Aplica-se a

Label(Type, String)

Parâmetros

Retornos

Aplica-se a

Recursos adicionais