InvocationExpression Class (System.Linq.Expressions)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

.NET Framework Class Library

InvocationExpression Class

Represents an expression that applies a delegate or lambda expression to a list of argument expressions.

Inheritance Hierarchy

System.Object
System.Linq.Expressions.Expression
System.Linq.Expressions.InvocationExpression

Namespace: System.Linq.Expressions
Assembly: System.Core (in System.Core.dll)

Syntax

Visual Basic

Public NotInheritable Class InvocationExpression _
	Inherits Expression

public sealed class InvocationExpression : Expression

Visual C++

public ref class InvocationExpression sealed : public Expression

[<Sealed>]
type InvocationExpression =  
    class
        inherit Expression
    end

The InvocationExpression type exposes the following members.

Properties

	Name	Description
	Arguments	Gets the arguments that the delegate or lambda expression is applied to.
	CanReduce	Indicates that the node can be reduced to a simpler node. If this returns true, Reduce() can be called to produce the reduced form. (Inherited from Expression.)
	Expression	Gets the delegate or lambda expression to be applied.
	NodeType	Returns the node type of this expression. Extension nodes should return Extension when overriding this method. (Overrides Expression.NodeType.)
	Type	Gets the static type of the expression that this Expression represents. (Overrides Expression.Type.)

Top

Methods

	Name	Description
	Accept	Dispatches to the specific visit method for this node type. For example, MethodCallExpression calls the VisitMethodCall. (Inherited from Expression.)
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Reduce	Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node which itself must be reduced. (Inherited from Expression.)
	ReduceAndCheck	Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node which itself must be reduced. (Inherited from Expression.)
	ReduceExtensions	Reduces the expression to a known node type (that is not an Extension node) or just returns the expression if it is already a known type. (Inherited from Expression.)
	ToString	Returns a textual representation of the Expression. (Inherited from Expression.)
	Update	Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.
	VisitChildren	Reduces the node and then calls the visitor delegate on the reduced expression. The method throws an exception if the node is not reducible. (Inherited from Expression.)

Top

Remarks

Use the Invoke factory methods to create an InvocationExpression.

The NodeType of an InvocationExpression is Invoke.

Examples

The following example creates an InvocationExpression that represents invoking a lambda expression with specified arguments.

Visual Basic


Dim largeSumTest As System.Linq.Expressions.Expression(Of System.Func(Of Integer, Integer, Boolean)) = _
    Function(num1, num2) (num1 + num2) > 1000

' Create an InvocationExpression that represents applying
' the arguments '539' and '281' to the lambda expression 'largeSumTest'.
Dim invocationExpression As System.Linq.Expressions.InvocationExpression = _
    System.Linq.Expressions.Expression.Invoke( _
        largeSumTest, _
        System.Linq.Expressions.Expression.Constant(539), _
        System.Linq.Expressions.Expression.Constant(281))

Console.WriteLine(invocationExpression.ToString())

' This code produces the following output:
'
' Invoke((num1, num2) => ((num1 + num2) > 1000),539,281)


System.Linq.Expressions.Expression<Func<int, int, bool>> largeSumTest =
    (num1, num2) => (num1 + num2) > 1000;

// Create an InvocationExpression that represents applying
// the arguments '539' and '281' to the lambda expression 'largeSumTest'.
System.Linq.Expressions.InvocationExpression invocationExpression =
    System.Linq.Expressions.Expression.Invoke(
        largeSumTest,
        System.Linq.Expressions.Expression.Constant(539),
        System.Linq.Expressions.Expression.Constant(281));

Console.WriteLine(invocationExpression.ToString());

// This code produces the following output:
//
// Invoke((num1, num2) => ((num1 + num2) > 1000),539,281)

Version Information

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

System.Linq.Expressions Namespace