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

Битовый оператор OR не определен для типов left.Type и right.Type.

-или-

Типы left.Type и right.Type отличаются от логического типа.

Примеры

В следующем примере кода показано, как создать выражение, представляющее логическую OR операцию, которая вычисляет второй операнд только в том случае, если первый операнд имеет falseзначение .

// 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 Если свойство объекта left или right представляет определяемый пользователем тип, который перегружает побитовый 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, узел отменяется. Тип узла является типом, допускающим значение NULL, который соответствует типу результата предопределенного условного OR оператора.

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 (Shared в Visual Basic), или не принимает ровно два аргумента.

InvalidOperationException

method имеет значение null, и оператор битовой операции OR не определен для left.Type и right.Type.

-или-

Метод method равен null, а типы left.Type и right.Type отличаются от логического типа.

Комментарии

Результирующее BinaryExpression свойство имеет Method значение реализующий метод. Свойству Type присваивается тип узла. Если узел снят, IsLifted свойства и IsLiftedToNull имеют значение true. В противном случае они имеют значение false. Значение свойства Conversion — null.

Ниже приведены сведения о реализуемом методе, типе узла и о том, удаляется ли узел.

Реализация метода

Следующие правила определяют метод реализации для операции:

• Если method имеет значение не null и представляет метод non-void ( staticShared в Visual Basic), который принимает два аргумента, он является реализующим методом для узла.

• В противном случае, если Type свойство объекта left или right представляет определяемый пользователем тип, который перегружает побитовый 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, узел отменяется. Тип узла является типом, допускающим значение NULL, который соответствует типу результата предопределенного условного OR оператора.