Expression.Equal 方法

定义

命名空间:

System.Linq.Expressions

程序集:

System.Linq.Expressions.dll

创建一个表示相等比较的 BinaryExpression。

重载

Equal(Expression, Expression)	创建一个表示相等比较的 BinaryExpression。
Equal(Expression, Expression, Boolean, MethodInfo)	创建一个表示相等比较的 BinaryExpression。 可指定实现方法。

Equal(Expression, Expression)

Source:

BinaryExpression.cs

创建一个表示相等比较的 BinaryExpression。

public:
 static System::Linq::Expressions::BinaryExpression ^ Equal(System::Linq::Expressions::Expression ^ left, System::Linq::Expressions::Expression ^ right);

public static System.Linq.Expressions.BinaryExpression Equal (System.Linq.Expressions.Expression left, System.Linq.Expressions.Expression right);

static member Equal : System.Linq.Expressions.Expression * System.Linq.Expressions.Expression -> System.Linq.Expressions.BinaryExpression

Public Shared Function Equal (left As Expression, right As Expression) As BinaryExpression

参数

left

Expression

要将 Expression 属性设置为与其相等的 Left。

right

Expression

要将 Expression 属性设置为与其相等的 Right。

返回

BinaryExpression

一个 BinaryExpression，其 NodeType 属性等于 Equal，并且其 Left 和 Right 属性设置为指定值。

例外

ArgumentNullException

left 或 right 为 null。

InvalidOperationException

没有为 left.Type 和 right.Type 定义相等运算符。

示例

下面的代码示例演示如何创建一个表达式，用于检查其两个参数的值是否相等。

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

// This expression compares the values of its two arguments.
// Both arguments need to be of the same type.
Expression equalExpr = Expression.Equal(
    Expression.Constant(42),
    Expression.Constant(45)
);

// Print out the expression.
Console.WriteLine(equalExpr.ToString());

// The following statement first creates an expression tree,
// then compiles it, and then executes it.
Console.WriteLine(
    Expression.Lambda<Func<bool>>(equalExpr).Compile()());

// This code example produces the following output:
//
// (42 == 45)
// False

' Add the following directive to your file:
' Imports System.Linq.Expressions  

' This expression compares the values of its two arguments.
' Both arguments must be of the same type.
Dim equalExpr As Expression = Expression.Equal(
    Expression.Constant(42),
    Expression.Constant(45)
)

' Print the expression.
Console.WriteLine(equalExpr.ToString())

' The following statement first creates an expression tree,
' then compiles it, and then executes it.
Console.WriteLine(
    Expression.Lambda(Of Func(Of Boolean))(equalExpr).Compile()())

' This code example produces the following output:
'
' (42 == 45)
' False

注解

生成的 BinaryExpression 将 Method 属性设置为 实现方法。 属性 Type 设置为节点的类型。 如果提升节点，则 IsLifted 属性为 true。 否则为 false。 IsLiftedToNull 属性始终为 false。 以下信息介绍了实现方法、节点类型以及是否提升节点。

实现方法

以下规则确定操作的实现方法：

• Type如果 或 right 的 left 属性表示重载相等运算符的用户定义类型，MethodInfo则表示该方法的 就是实现方法。

• 否则，实现方法是 null。

节点类型和提升与非提升

如果实现方法不是 null：

• 如果 left为 。键入 和 right。类型可分配给实现方法的相应参数类型，节点不会提升。 节点的类型是实现方法的返回类型。

• 如果满足以下两个条件，则提升节点，节点类型为 Boolean：

  • left.键入 和 right。类型是两种值类型，其中至少有一种可为 null，相应的不可为 null 类型等于实现方法的相应参数类型。

  • 实现方法的返回类型为 Boolean。

如果实现方法是 null：

• 如果 left为 。键入 和 right。类型都是不可为 null 的，节点不会解除。 节点的类型为 Boolean。

• 如果 left为 。键入 和 right。类型都是可以为 null 的，节点是提升的。 节点的类型为 Boolean。

Equal(Expression, Expression, Boolean, MethodInfo)

Source:

BinaryExpression.cs

创建一个表示相等比较的 BinaryExpression。 可指定实现方法。

public:
 static System::Linq::Expressions::BinaryExpression ^ Equal(System::Linq::Expressions::Expression ^ left, System::Linq::Expressions::Expression ^ right, bool liftToNull, System::Reflection::MethodInfo ^ method);

public static System.Linq.Expressions.BinaryExpression Equal (System.Linq.Expressions.Expression left, System.Linq.Expressions.Expression right, bool liftToNull, System.Reflection.MethodInfo? method);

static member Equal : System.Linq.Expressions.Expression * System.Linq.Expressions.Expression * bool * System.Reflection.MethodInfo -> System.Linq.Expressions.BinaryExpression

Public Shared Function Equal (left As Expression, right As Expression, liftToNull As Boolean, method As MethodInfo) As BinaryExpression

参数

left

Expression

要将 Expression 属性设置为与其相等的 Left。

right

Expression

要将 Expression 属性设置为与其相等的 Right。

liftToNull

Boolean

若要将 true 设置为 IsLiftedToNull，则为 true；若要将 false 设置为 IsLiftedToNull，则为 false。

method

MethodInfo

要将 MethodInfo 属性设置为与其相等的 Method。

返回

BinaryExpression

一个 BinaryExpression，其 NodeType 属性等于 Equal，并且其 Left、Right、IsLiftedToNull 和 Method 属性设置为指定值。

例外

ArgumentNullException

left 或 right 为 null。

ArgumentException

method 不是 null，它所表示的方法返回 void，而不是 static（Visual Basic 中为 Shared），或者并非采用两个参数。

InvalidOperationException

method 为 null，并且没有为 left.Type 和 right.Type 定义相等运算符。

注解

生成的 BinaryExpression 将 Method 属性设置为 实现方法。 属性 Type 设置为节点的类型。 如果提升节点，则 IsLifted 属性为 true ， IsLiftedToNull 属性等于 liftToNull。 否则，它们都是 false。 以下信息介绍了实现方法、节点类型以及是否提升节点。

实现方法

以下规则确定操作的实现方法：

• 如果 method 不是 null ，它表示非 void， static (Shared Visual Basic) 方法中采用两个参数，则为实现方法。

• 否则，如果 Type 或 right 的 left 属性表示重载相等运算符的用户定义类型，MethodInfo则表示该方法的 就是实现方法。

• 否则，实现方法是 null。

节点类型和提升与非提升

如果实现方法不是 null：

• 如果 left为 。键入 和 right。类型可分配给实现方法的相应参数类型，节点不会提升。 节点的类型是实现方法的返回类型。

• 如果满足以下两个条件，则会提升节点：此外，如果 liftToNull 为 或 liftToNullfalseBoolean ，true则节点的类型可为 Boolean null。

  • left.键入 和 right。类型是两种值类型，其中至少有一种可为 null，相应的不可为 null 类型等于实现方法的相应参数类型。

  • 实现方法的返回类型为 Boolean。

如果实现方法是 null：

• 如果 left为 。键入 和 right。类型都是不可为 null 的，节点不会解除。 节点的类型为 Boolean。

• 如果 left为 。键入 和 right。类型都是可以为 null 的，节点是提升的。 如果 liftToNull 为 或 liftToNullfalseBoolean ，true则节点的类型可为 Boolean null。