Export (0) Print
Expand All

Expression.New Method (ConstructorInfo, IEnumerable(Expression), MemberInfo[])

Creates a NewExpression that represents calling the specified constructor with the specified arguments. The members that access the constructor initialized fields are specified as an array.

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

static member New : 
        constructor:ConstructorInfo * 
        arguments:IEnumerable<Expression> * 
        members:MemberInfo[] -> NewExpression

Parameters

constructor
Type: System.Reflection.ConstructorInfo

The ConstructorInfo to set the Constructor property equal to.

arguments
Type: System.Collections.Generic.IEnumerable(Expression)

An IEnumerable(T) that contains Expression objects to use to populate the Arguments collection.

members
Type: System.Reflection.MemberInfo[]

An array of MemberInfo objects to use to populate the Members collection.

Return Value

Type: System.Linq.Expressions.NewExpression
A NewExpression that has the NodeType property equal to New and the Constructor, Arguments and Members properties set to the specified values.

ExceptionCondition
ArgumentNullException

constructor is a null reference (Nothing in Visual Basic).

-or-

An element of arguments is a null reference (Nothing in Visual Basic).

-or-

An element of members is a null reference (Nothing in Visual Basic).

ArgumentException

The arguments parameter does not contain the same number of elements as the number of parameters for the constructor that constructor represents.

-or-

The Type property of an element of arguments is not assignable to the type of the corresponding parameter of the constructor that constructor represents.

-or-

The members parameter does not have the same number of elements as arguments.

-or-

An element of arguments has a Type property that represents a type that is not assignable to the type of the member that is represented by the corresponding element of members.

The arguments parameter must contain the same number of elements as the number of parameters for the constructor represented by constructor. If arguments is a null reference (Nothing in Visual Basic), it is considered empty, and the Arguments property of the resulting NewExpression is an empty collection.

If members is a null reference (Nothing in Visual Basic), the Members property of the resulting NewExpression is an empty collection. If members is not a null reference (Nothing in Visual Basic), it must have the same number of elements as arguments and each element must not be a null reference (Nothing in Visual Basic). Each element of members must be a PropertyInfo, FieldInfo or MethodInfo that represents an instance member on the declaring type of the constructor represented by constructor. If it represents a property, the property must be able to retrieve the value of the associated field. The corresponding element of arguments for each element of members must have a Type property that represents a type that is assignable to the type of the member that the members element represents.

The Type property of the resulting NewExpression represents the declaring type of the constructor that constructor represents.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft