Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Expression.NewArrayInit Method (Type, Expression[])

Creates a NewArrayExpression that represents creating a one-dimensional array and initializing it from a list of elements.

Namespace:  System.Linq.Expressions
Assembly:  System.Core (in System.Core.dll)
public static NewArrayExpression NewArrayInit(
	Type type,
	params Expression[] initializers
)

Parameters

type
Type: System.Type
A Type that represents the element type of the array.
initializers
Type: System.Linq.Expressions.Expression[]
An array of Expression objects to use to populate the Expressions collection.

Return Value

Type: System.Linq.Expressions.NewArrayExpression
A NewArrayExpression that has the NodeType property equal to NewArrayInit and the Expressions property set to the specified value.
ExceptionCondition
ArgumentNullException

type or initializers is null.

-or-

An element of initializers is null.

InvalidOperationException

The Type property of an element of initializers represents a type that is not assignable to the type type.

The Type property of each element of initializers must represent a type that is assignable to the type represented by type, possibly after it is quoted.

NoteNote

An element will be quoted only if type is Expression. Quoting means the element is wrapped in a Quote node. The resulting node is a UnaryExpression whose Operand property is the element of initializers.

The Type property of the resulting NewArrayExpression represents an array type whose rank is 1 and whose element type is type.

The following example demonstrates how to use the NewArrayInit method to create an expression tree that represents creating a one-dimensional string array that is initialized with a list of string expressions.


List<System.Linq.Expressions.Expression> trees =
    new List<System.Linq.Expressions.Expression>()
        { System.Linq.Expressions.Expression.Constant("oak"),
          System.Linq.Expressions.Expression.Constant("fir"),
          System.Linq.Expressions.Expression.Constant("spruce"),
          System.Linq.Expressions.Expression.Constant("alder") };

// Create an expression tree that represents creating and  
// initializing a one-dimensional array of type string.
System.Linq.Expressions.NewArrayExpression newArrayExpression =
    System.Linq.Expressions.Expression.NewArrayInit(typeof(string), trees);

// Output the string representation of the Expression.
Console.WriteLine(newArrayExpression.ToString());

// This code produces the following output:
//
// new [] {"oak", "fir", "spruce", "alder"}


.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

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.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.