NewArrayBounds Method (Type, Expression[])

Expression.NewArrayBounds Method (Type, Expression[])

 

Creates a NewArrayExpression that represents creating an array that has a specified rank.

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

public static NewArrayExpression NewArrayBounds(
	Type type,
	params Expression[] bounds
)

Parameters

type
Type: System.Type

A Type that represents the element type of the array.

bounds
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 NewArrayBounds and the Expressions property set to the specified value.

Exception Condition
ArgumentNullException

type or bounds is null.

-or-

An element of bounds is null.

ArgumentException

The Type property of an element of bounds does not represent an integral type.

The Type property of the resulting NewArrayExpression represents an array type whose rank is equal to the length of bounds and whose element type is type.

The Type property of each element of bounds must represent an integral type.

The following example demonstrates how to use the NewArrayBounds method to create an expression tree that represents creating a string array that has a rank of 2.

// Create an expression tree that represents creating a 
// two-dimensional array of type string with bounds [3,2].
System.Linq.Expressions.NewArrayExpression newArrayExpression =
    System.Linq.Expressions.Expression.NewArrayBounds(
            typeof(string),
            System.Linq.Expressions.Expression.Constant(3),
            System.Linq.Expressions.Expression.Constant(2));

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

// This code produces the following output:
//
// new System.String[,](3, 2)

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show:
© 2016 Microsoft