# 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.