Expression.Equal Méthode

Définition

Espace de noms:

System.Linq.Expressions

Assembly:

System.Linq.Expressions.dll

Crée un BinaryExpression qui représente une comparaison d'égalité.

Surcharges

Equal(Expression, Expression)	Crée un BinaryExpression qui représente une comparaison d'égalité.
Equal(Expression, Expression, Boolean, MethodInfo)	Crée un BinaryExpression qui représente une comparaison d'égalité. La méthode d'implémentation peut être spécifiée.

Equal(Expression, Expression)

Source:

BinaryExpression.cs

Crée un BinaryExpression qui représente une comparaison d'égalité.

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

Paramètres

left

Expression

Expression auquel la propriété Left doit être égale.

right

Expression

Expression auquel la propriété Right doit être égale.

Retours

BinaryExpression

BinaryExpression dont la propriété NodeType est égale à Equal et dont les propriétés Left et Right ont les valeurs spécifiées.

Exceptions

ArgumentNullException

left ou right est null.

InvalidOperationException

L'opérateur d'égalité n'est pas défini pour left.Type et right.Type.

Exemples

L’exemple de code suivant montre comment créer une expression qui vérifie si les valeurs de ses deux arguments sont égales.

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

Remarques

La propriété résultante BinaryExpression est Method définie sur la méthode d’implémentation. La Type propriété est définie sur le type du nœud. Si le nœud est levé, la IsLifted propriété est true. Sinon, c’est false. La propriété IsLiftedToNull a toujours la valeur false. Les informations suivantes décrivent la méthode d’implémentation, le type de nœud et si un nœud est levé.

Implémentation de la méthode

Les règles suivantes déterminent la méthode d’implémentation de l’opération :

• Si la Type propriété de left ou right représente un type défini par l’utilisateur qui surcharge l’opérateur d’égalité, le MethodInfo qui représente cette méthode est la méthode d’implémentation.

• Sinon, la méthode d’implémentation est null.

Type de nœud et lifté par rapport à non lifté

Si la méthode d’implémentation n’est pas null:

• Si left. Tapez et right. Les types sont assignables aux types d’arguments correspondants de la méthode d’implémentation. Le nœud n’est pas levé. Le type du nœud est le type de retour de la méthode d’implémentation.

• Si les deux conditions suivantes sont remplies, le nœud est levé et le type du nœud est Boolean:

  • left. Tapez et right. Les types de valeurs sont les deux types de valeurs dont au moins un est nullable et les types non nullables correspondants sont égaux aux types d’arguments correspondants de la méthode d’implémentation.

  • Le type de retour de la méthode d’implémentation est Boolean.

Si la méthode d’implémentation est null:

• Si left. Tapez et right. Les types sont tous deux non nullables, le nœud n’est pas levé. Le type du nœud est Boolean.

• Si left. Tapez et right. Les types sont tous deux nullables, le nœud est levé. Le type du nœud est Boolean.

Equal(Expression, Expression, Boolean, MethodInfo)

Source:

BinaryExpression.cs

Crée un BinaryExpression qui représente une comparaison d'égalité. La méthode d'implémentation peut être spécifiée.

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

Paramètres

left

Expression

Expression auquel la propriété Left doit être égale.

right

Expression

Expression auquel la propriété Right doit être égale.

liftToNull

Boolean

true pour affecter à IsLiftedToNull la valeur true ; false pour affecter à IsLiftedToNull la valeur false.

method

MethodInfo

MethodInfo auquel la propriété Method doit être égale.

Retours

BinaryExpression

BinaryExpression dont la propriété NodeType est égale à Equal et dont les propriétés Left, Right, IsLiftedToNull et Method ont les valeurs spécifiées.

Exceptions

ArgumentNullException

left ou right est null.

ArgumentException

method n’est pas null et la méthode représentée retourne void, pas static (Shared dans Visual Basic) ou ne prend pas exactement deux arguments.

InvalidOperationException

method est null et l'opérateur d'égalité n'est pas défini pour left.Type et right.Type.

Remarques

La propriété résultante BinaryExpression est Method définie sur la méthode d’implémentation. La Type propriété est définie sur le type du nœud. Si le nœud est levé, la IsLifted propriété est true et la IsLiftedToNull propriété est égale à liftToNull. Sinon, ils sont tous les deux false. Les informations suivantes décrivent la méthode d’implémentation, le type de nœud et si un nœud est levé.

Implémentation de la méthode

Les règles suivantes déterminent la méthode d’implémentation de l’opération :

• Si method n’est pas null et qu’il représente une méthode non void ( staticShared en Visual Basic) qui prend deux arguments, il s’agit de la méthode d’implémentation.

• Sinon, si la Type propriété de left ou right représente un type défini par l’utilisateur qui surcharge l’opérateur d’égalité, le MethodInfo qui représente cette méthode est la méthode d’implémentation.

• Sinon, la méthode d’implémentation est null.

Type de nœud et lifté par rapport à non lifté

Si la méthode d’implémentation n’est pas null:

• Si left. Tapez et right. Les types sont assignables aux types d’arguments correspondants de la méthode d’implémentation. Le nœud n’est pas levé. Le type du nœud est le type de retour de la méthode d’implémentation.

• Si les deux conditions suivantes sont remplies, le nœud est levé ; en outre, le type du nœud est nullable Boolean si liftToNull est true ou Boolean si liftToNull est false:

  • left. Tapez et right. Les types de valeurs sont les deux types de valeurs dont au moins un est nullable et les types non nullables correspondants sont égaux aux types d’arguments correspondants de la méthode d’implémentation.

  • Le type de retour de la méthode d’implémentation est Boolean.

Si la méthode d’implémentation est null:

• Si left. Tapez et right. Les types sont tous deux non nullables, le nœud n’est pas levé. Le type du nœud est Boolean.

• Si left. Tapez et right. Les types sont tous deux nullables, le nœud est levé. Le type du nœud est nullable Boolean si liftToNull est true ou Boolean si liftToNull est false.