The following table lists the instruction's hexadecimal and Microsoft Intermediate Language (MSIL) assembly format, along with a brief reference summary:

8D < T >	newarr etype	Creates a new array with elements of type etype.

The stack transitional behavior, in sequential order, is:

[The 'ordered' type of list has not been implemented in the ECMA stylesheet.]

The newarr instruction pushes an object reference (type O) to a new zero-based, one-dimensional array whose elements are of type etype (a metadata token describing the type). The number of elements in the new array should be specified as a native int. Valid array indexes range from zero to the maximum number of elements minus one.

The elements of an array can be any type, including value types.

Zero-based, one-dimensional arrays of numbers are created using a metadata token referencing the appropriate value type (int, and so on). Elements of the array are initialized to 0 of the appropriate type.

Nonzero-based one-dimensional arrays and multidimensional arrays are created using OpCodes.Newobj rather than newarr. More commonly, they are created using the methods of the Array class in the .NET Framework.

OutOfMemoryException is thrown if there is insufficient memory to satisfy the request.

OverflowException is thrown if numElems is less than 0.

The following ILGenerator.Emit(OpCode) method overload can use the newarr opcode:

• ILGenerator.Emit(OpCode, Type)

Namespace: System.Reflection.Emit
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0