Array.Rank Property

Definition

Ruft den Rang (Anzahl der Dimensionen) von Array ab.Gets the rank (number of dimensions) of the Array. Ein eindimensionales Array gibt z. B. 1 zurück, ein zweidimensionales Array gibt 2 zurück usw.For example, a one-dimensional array returns 1, a two-dimensional array returns 2, and so on.

public:
 property int Rank { int get(); };
public int Rank { get; }
member this.Rank : int
Public ReadOnly Property Rank As Integer

Property Value

Int32

Der Rang (Anzahl der Dimensionen) von Array.The rank (number of dimensions) of the Array.

Examples

Im folgenden Beispiel wird ein eindimensionales Array, ein zweidimensionales Array und ein Jagged Array initialisiert, und die Rank-Eigenschaft der einzelnen wird abgerufen.The following example initializes a one-dimensional array, a two-dimensional array, and a jagged array, and retrieves the Rank property of each.

using System;

public class Example
{
   public static void Main()
   {
      int[] array1 = new int[10];
      int[,] array2= new int[10,3];
      int[][] array3 = new int[10][];

      Console.WriteLine("{0}: {1} dimension(s)",
                        array1.ToString(), array1.Rank);
      Console.WriteLine("{0}: {1} dimension(s)",
                        array2.ToString(), array2.Rank);
      Console.WriteLine("{0}: {1} dimension(s)",
                        array3.ToString(), array3.Rank);
   }
}
// The example displays the following output:
//       System.Int32[]: 1 dimension
//       System.Int32[,]: 2 dimension
//       System.Int32[][]: 1 dimension
Module Example
   Public Sub Main()
      Dim array1(9) As Integer 
      Dim array2(9,2) As Integer  
      Dim array3(9)() As Integer 
      
      Console.WriteLine("{0}: {1} dimension(s)", 
                        array1.ToString(), array1.Rank)
      Console.WriteLine("{0}: {1} dimension(s)", 
                        array2.ToString(), array2.Rank)
      Console.WriteLine("{0}: {1} dimension(s)", 
                        array3.ToString(), array3.Rank)
   End Sub
End Module
' The example displays the following output:
'       System.Int32[]: 1 dimension
'       System.Int32[,]: 2 dimension
'       System.Int32[][]: 1 dimension

Remarks

Beispielsweise der Visual Basic CodeFor example, the Visual Basic code

Dim TDArray(0,0,0) As Integer  

und der C# Codeand the C# code

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

Erstellen Sie ein Array mit drei Dimensionen mit einer Rank-Eigenschaft, deren Wert 3 ist.create an array of three dimensions with a Rank property whose value is 3.

Ein Jagged Array (ein Array von Arrays) ist ein eindimensionales Array. der Wert der Rank-Eigenschaft ist 1.A jagged array (an array of arrays) is a one-dimensional array; the value of its Rank property is 1.

Das Abrufen des Werts dieser Eigenschaft ist ein O(1)-Vorgang.Retrieving the value of this property is an O(1) operation.

Applies to

See also