Array.Rank Propriété

Définition

Obtient le rang (nombre de dimensions) du Array.Gets the rank (number of dimensions) of the Array. Par exemple, un tableau unidimensionnel retourne 1, un tableau bidimensionnel retourne 2, etc.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

Valeur de propriété

Rang (nombre de dimensions) du Array.The rank (number of dimensions) of the Array.

Exemples

L’exemple suivant initialise un tableau unidimensionnel, un tableau à deux dimensions et un tableau en escalier, et récupère la propriété Rank de chaque.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

Remarques

Par exemple, le code Visual BasicFor example, the Visual Basic code

Dim TDArray(0,0,0) As Integer  

et le C# codeand the C# code

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

Créez un tableau de trois dimensions avec une propriété Rank dont la valeur est 3.create an array of three dimensions with a Rank property whose value is 3.

Un tableau en escalier (tableau de tableaux) est un tableau unidimensionnel ; la valeur de sa propriété Rank est 1.A jagged array (an array of arrays) is a one-dimensional array; the value of its Rank property is 1.

La récupération de la valeur de cette propriété est une opération O(1).Retrieving the value of this property is an O(1) operation.

S’applique à

Voir aussi