Expression.OrElse 方法

定義

命名空間:

System.Linq.Expressions

組件:

System.Linq.Expressions.dll

建立 BinaryExpression，表示只在第一個運算子評估為 OR 時才評估第二個運算元的條件 false 運算。

多載

OrElse(Expression, Expression)	建立 BinaryExpression，表示只在第一個運算元計算結果為 OR 時才求第二個運算元之值的 false 條件運算。
OrElse(Expression, Expression, MethodInfo)	建立 BinaryExpression，表示只在第一個運算元計算結果為 OR 時才求第二個運算元之值的 false 條件運算。

OrElse(Expression, Expression)

來源:

BinaryExpression.cs

建立 BinaryExpression，表示只在第一個運算元計算結果為 OR 時才求第二個運算元之值的 false 條件運算。

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

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

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

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

參數

left

Expression

要將 Expression 屬性設定為與之相等的 Left。

right

Expression

要將 Expression 屬性設定為與之相等的 Right。

傳回

BinaryExpression

BinaryExpression，其 NodeType 屬性等於 OrElse，且 Left 和 Right 屬性設定為指定的值。

例外狀況

ArgumentNullException

left 或 right 為 null。

InvalidOperationException

不會為 left.Type 和 right.Type 定義位元 OR 運算子。

-或-

left.Type 和 right.Type 是不相同的布林類型。

範例

下列程式代碼範例示範如何建立表達式，代表只有在第一個操作數評估為 false時，才會評估第二個操作數的邏輯OR作業。

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

// This expression perfroms a logical OR operation
// on its two arguments, but if the first argument is true,
// then the second arument is not evaluated.
// Both arguments must be of the boolean type.
Expression orElseExpr = Expression.OrElse(
    Expression.Constant(false),
    Expression.Constant(true)
);

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

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

// This code example produces the following output:
//
// (False OrElse True)
// True

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

' This expression perfroms a logical OR operation
' on its two arguments, but if the first argument is true,
' the second arument is not evaluated.
' Both arguments must be of the Boolean type.
Dim orElseExpr As Expression = Expression.OrElse(
     Expression.Constant(False),
     Expression.Constant(True)
 )

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

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

' This code example produces the following output:
'
' (False OrElse True)
' True

備註

產生的 BinaryExpression 屬性 Method 會設定為實作方法。 屬性 Type 會設定為節點的類型。 如果節點隨即提升， IsLifted 則與 IsLiftedToNull 屬性都是 true。 否則，它們是 false。 Conversion 屬性為 null。

下列資訊描述實作方法、節點類型，以及節點是否已隨即提升。

實作方法

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

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

  注意

  條件 OR 運算子無法在 C# 或 Visual Basic 中多載。 不過，條件 OR 運算符是使用位 OR 運算符來評估。 因此，位 OR 運算子的使用者定義多載可以是這個節點類型的實作方法。

• 否則，如果 left為 。輸入與 right。類型為布爾類型，實作方法為 null。

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

如果實作方法不是 null：

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

• 如果滿足下列兩個條件，則會隨即啟動節點，而節點的類型是對應至實作方法之傳回型別的可為 Null 類型：

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

  • 實作方法的傳回型別是不可為 Null 的實值型別。

如果實作方法為 null：

• left.輸入與 right。類型是相同的布爾類型。

• 如果為 left。輸入與 right。類型不可為 Null，節點不會隨即解除。 節點的類型是預先定義條件 OR 運算子的結果類型。

• 如果為 left。輸入與 right。類型為可為 Null，節點隨即隨即提升。 節點的類型是對應至預先定義條件 OR 運算子結果類型的可為 Null 的類型。

OrElse(Expression, Expression, MethodInfo)

來源:

BinaryExpression.cs

建立 BinaryExpression，表示只在第一個運算元計算結果為 OR 時才求第二個運算元之值的 false 條件運算。

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

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

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

Public Shared Function OrElse (left As Expression, right As Expression, method As MethodInfo) As BinaryExpression

參數

left

Expression

要將 Expression 屬性設定為與之相等的 Left。

right

Expression

要將 Expression 屬性設定為與之相等的 Right。

method

MethodInfo

要將 MethodInfo 屬性設定為與之相等的 Method。

傳回

BinaryExpression

BinaryExpression，其 NodeType 屬性等於 OrElse，且 Left、Right 和 Method 屬性設定為指定的值。

例外狀況

ArgumentNullException

left 或 right 為 null。

ArgumentException

method 不是 null，而它所代表的方法會傳回 void、不是 static (Visual Basic 中的 Shared)，或者未確切採用兩個引數。

InvalidOperationException

method 是 null，而且未定義 left.Type 和 right.Type 的位元 OR 運算子。

-或-

method 為 null，且 left.Type 和 right.Type 不是相同的布林類型。

備註

產生的 BinaryExpression 屬性 Method 會設定為實作方法。 屬性 Type 會設定為節點的類型。 如果節點隨即提升， IsLifted 則與 IsLiftedToNull 屬性都是 true。 否則，它們是 false。 Conversion 屬性為 null。

下列資訊描述實作方法、節點類型，以及節點是否已隨即提升。

實作方法

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

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

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

  注意

  條件 OR 運算子無法在 C# 或 Visual Basic 中多載。 不過，條件 OR 運算符是使用位 OR 運算符來評估。 因此，位 OR 運算子的使用者定義多載可以是這個節點類型的實作方法。

• 否則，如果 left為 。輸入與 right。類型為布爾類型，實作方法為 null。

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

如果實作方法不是 null：

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

• 如果滿足下列兩個條件，則會隨即啟動節點，而節點的類型是對應至實作方法之傳回型別的可為 Null 類型：

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

  • 實作方法的傳回型別是不可為 Null 的實值型別。

如果實作方法為 null：

• left.輸入與 right。類型是相同的布爾類型。

• 如果為 left。輸入與 right。類型不可為 Null，節點不會隨即解除。 節點的類型是預先定義條件 OR 運算子的結果類型。

• 如果為 left。輸入與 right。類型為可為 Null，節點隨即隨即提升。 節點的類型是對應至預先定義條件 OR 運算子結果類型的可為 Null 的類型。