Gets the number of dimensions in an Array.
Assembly: mscorlib (in mscorlib.dll)
Syntax . . :: . GetArrayRank() () ()
Public Overridable Function GetArrayRank As Integerpublic virtual int GetArrayRank()public:
virtual int GetArrayRank()abstract GetArrayRank : unit -> int
override GetArrayRank : unit -> int Implements
_Type Exceptions
| Exception | Condition |
|---|---|
| NotSupportedException | The functionality of this method is unsupported in the base class and must be implemented in a derived class instead. |
| ArgumentException | The current Type is not an array. |
Examples
The following example displays the number of dimensions in an array.
Imports System
Imports Microsoft.VisualBasic
Class MyArrayRankSample
Public Shared Sub Main()
Try
Dim myArray(,,) As Integer = {{{12, 2, 35}, {300, 78, 33}}, {{92, 42, 135}, {30, 7, 3}}}
Dim myType As Type = myArray.GetType()
Console.WriteLine("Contents of myArray: {{{12,2,35},{300,78,33}},{{92,42,135},{30,7,3}}}")
Console.WriteLine("myArray has {0} dimensions.", myType.GetArrayRank())
Catch e As NotSupportedException
Console.WriteLine("NotSupportedException raised.")
Console.WriteLine(("Source: " + e.Source))
Console.WriteLine(("Message: " + e.Message))
Catch e As Exception
Console.WriteLine("Exception raised.")
Console.WriteLine(("Source: " + e.Source))
Console.WriteLine(("Message: " + e.Message))
End Try
End Sub 'Main
End Class 'MyArrayRankSample
using System;
class MyArrayRankSample
{
public static void Main()
{
try
{
int[,,] myArray = new int[,,] {{{12,2,35},{300,78,33}},{{92,42,135},{30,7,3}}};
Type myType = myArray.GetType();
Console.WriteLine("Contents of myArray: {{{12,2,35},{300,78,33}},{{92,42,135},{30,7,3}}}");
Console.WriteLine("myArray has {0} dimensions.", myType.GetArrayRank());
}
catch(NotSupportedException e)
{
Console.WriteLine("NotSupportedException raised.");
Console.WriteLine("Source: " + e.Source);
Console.WriteLine("Message: " + e.Message);
}
catch(Exception e)
{
Console.WriteLine("Exception raised.");
Console.WriteLine("Source: " + e.Source);
Console.WriteLine("Message: " + e.Message);
}
}
}
using namespace System;
int main()
{
try
{
array<Int32, 3>^myArray = gcnew array<Int32,3>(3,4,5);
Type^ myType = myArray->GetType();
Console::WriteLine( "myArray has {0} dimensions.", myType->GetArrayRank() );
}
catch ( NotSupportedException^ e )
{
Console::WriteLine( "NotSupportedException raised." );
Console::WriteLine( "Source: {0}", e->Source );
Console::WriteLine( "Message: {0}", e->Message );
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception raised." );
Console::WriteLine( "Source: {0}", e->Source );
Console::WriteLine( "Message: {0}", e->Message );
}
}
Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, 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.