Expression.Equal 方法

定義

命名空間:

System.Linq.Expressions

組件:

System.Linq.Expressions.dll

建立代表相等比較的 BinaryExpression。

多載

Equal(Expression, Expression)	建立代表相等比較的 BinaryExpression。
Equal(Expression, Expression, Boolean, MethodInfo)	建立代表相等比較的 BinaryExpression。 實作的方法可加以指定。

Equal(Expression, Expression)

來源:

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

備註

產生的 BinaryExpressionMethod 屬性已設定為實作方法。 屬性 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)

來源:

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 定義等號比較運算子。

備註

產生的 BinaryExpressionMethod 屬性已設定為實作方法。 屬性 Type 會設定為節點的類型。 如果節點隨即轉移，則 IsLifted 屬性為 true ，而 IsLiftedToNull 屬性等於 liftToNull。 否則，兩者都是 false。 下列資訊描述實作方法、節點類型，以及節點是否已增益。

實作方法

下列規則會決定作業的實作方法：

• 如果 method 不是 null ，而且它代表非 void， static 在 Shared 採用兩個自變數的 Visual Basic) 方法中 (，則為實作方法。

• 否則，如果 Type 或 right 的 left 屬性代表多載等號比較運算子的使用者定義型別，MethodInfo則表示該方法的 是實作方法。

• 否則，實作方法為 null。

節點類型和隨即轉移與非隨即轉移的比較

如果實作方法不是 null：

• 如果為 left。輸入與 right。類型可指派給實作方法的對應自變數類型，節點不會隨即解除。 節點的類型是實作方法的傳回型別。

• 如果滿足下列兩個條件，則會隨即解除節點;此外，如果 為 true ，則節點的類型可為 Boolean Null;如果 liftToNull 為 ，Boolean則falseliftToNull為 ：

  • left.輸入與 right。類型是兩種實值型別，其中至少有一個可為 Null，而對應的不可為 Null 型別等於實作方法的對應自變數類型。

  • 實作方法的傳回型別為 Boolean。

如果實作方法為 null：

• 如果為 left。輸入與 right。類型都是不可為 Null 的，節點不會隨即解除。 節點的類型為 Boolean。

• 如果為 left。輸入與 right。類型都是可為 Null 的，節點會隨即隨即解除。 如果 為 ，則節點的類型可為 Boolean Null，如果 trueliftToNull 為 ，Boolean則falseliftToNull為 。