Array::Rank Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets the rank (number of dimensions) of the Array. For example, a one-dimensional array returns 1, a two-dimensional array returns 2, and so on.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

property int Rank {
	int get();

Property Value

Type: System::Int32

The rank (number of dimensions) of the Array.

For example, the Visual Basic code

Dim TDArray(0,0,0) As Integer

and the C# code

int[,,] TDArray = new int[1,1,1];

create an array of three dimensions with a Rank property whose value is 3.

A jagged array (an array of arrays) is a one-dimensional array; the value of its Rank property is 1.

Retrieving the value of this property is an O(1) operation.

The following example initializes a one-dimensional array, a two-dimensional array, and a jagged array, and retrieves the Rank property of each.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top