Expression.Label Methode

Referenz

Definition

Namespace:: System.Linq.Expressions

Assembly:: System.Linq.Expressions.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein LabelTarget, das eine Bezeichnung darstellt.

Überlädt

Label()	Erstellt ein LabelTarget, das eine Bezeichnung mit Void-Typ und ohne Namen darstellt.
Label(LabelTarget)	Erstellt eine LabelExpression, die eine Bezeichnung ohne Standardwert darstellt.
Label(String)	Erstellt ein LabelTarget, das eine Bezeichnung mit Void-Typ und dem angegebenen Namen darstellt.
Label(Type)	Erstellt ein LabelTarget, das eine Bezeichnung mit dem angegebenen Typ darstellt.
Label(LabelTarget, Expression)	Erstellt eine LabelExpression, die eine Bezeichnung mit dem angegebenen Standardwert darstellt.
Label(Type, String)	Erstellt ein LabelTarget, das eine Bezeichnung mit dem angegebenen Typ und Namen darstellt.

Label()

Erstellt ein LabelTarget, das eine Bezeichnung mit Void-Typ und ohne Namen darstellt.

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

Gibt zurück

LabelTarget

Die neue LabelTarget.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie einen Ausdruck erstellen, der ein LabelTarget Objekt enthält.

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

Gilt für

Label(LabelTarget)

Erstellt eine LabelExpression, die eine Bezeichnung ohne Standardwert darstellt.

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

Parameter

target: LabelTarget

Das LabelTarget, dem diese LabelExpression zugeordnet wird.

Gibt zurück

LabelExpression

Ein LabelExpression ohne Standardwert.

Gilt für

Label(String)

Erstellt ein LabelTarget, das eine Bezeichnung mit Void-Typ und dem angegebenen Namen darstellt.

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

Parameter

name: String

Der Name der Sprungmarke.

Gibt zurück

LabelTarget

Die neue LabelTarget.

Gilt für

Label(Type)

Erstellt ein LabelTarget, das eine Bezeichnung mit dem angegebenen Typ darstellt.

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

Parameter

type: Type

Der Werttyp, der beim Springen zur Bezeichnung übergeben wird.

Gibt zurück

LabelTarget

Die neue LabelTarget.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein LabelTarget Objekt in einem Schleifenausdruck verwendet wird.

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

Gilt für

Label(LabelTarget, Expression)

Erstellt eine LabelExpression, die eine Bezeichnung mit dem angegebenen Standardwert darstellt.

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

Parameter

target: LabelTarget

Das LabelTarget, dem diese LabelExpression zugeordnet wird.

defaultValue: Expression

Der Wert dieses LabelExpression, wenn die Bezeichnung über die normale Ablaufsteuerung erreicht wird.

Gibt zurück

LabelExpression

Eine LabelExpression mit dem angegebenen Standardwert.

Gilt für

Label(Type, String)

Erstellt ein LabelTarget, das eine Bezeichnung mit dem angegebenen Typ und Namen darstellt.

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

Parameter

type: Type

Der Werttyp, der beim Springen zur Bezeichnung übergeben wird.

name: String

Der Name der Sprungmarke.

Gibt zurück

LabelTarget

Die neue LabelTarget.

Gilt für

Expression.Label Methode

Definition

Überlädt

Label()

Gibt zurück

Beispiele

Gilt für

Label(LabelTarget)

Parameter

Gibt zurück

Gilt für

Label(String)

Parameter

Gibt zurück

Gilt für

Label(Type)

Parameter

Gibt zurück

Beispiele

Gilt für

Label(LabelTarget, Expression)

Parameter

Gibt zurück

Gilt für

Label(Type, String)

Parameter

Gibt zurück

Gilt für

Zusätzliche Ressourcen