Partilhar via


Array.Rank Propriedade

Definição

Obtém a classificação (número de dimensões) do Array. Por exemplo, uma matriz unidimensional retorna 1, uma matriz bidimensional retorna 2 e assim por diante.

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

Valor da propriedade

Int32

A classificação (número de dimensões) do Array.

Exemplos

O exemplo a seguir inicializa uma matriz unidimensional, uma matriz bidimensional e uma matriz irregular e recupera a Rank propriedade de cada uma.

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(s)
//       System.Int32[,]: 2 dimension(s)
//       System.Int32[][]: 1 dimension(s)
let array1 = Array.zeroCreate<int> 10
let array2 = Array2D.zeroCreate<int> 10 3
let array3 = Array.zeroCreate<int[]> 10

printfn $"{array1}: {array1.Rank} dimension(s)"

printfn $"{array2}: {array2.Rank} dimension(s)"

printfn $"{array3}: {array3.Rank} dimension(s)"

// The example displays the following output:
//       System.Int32[]: 1 dimension(s)
//       System.Int32[,]: 2 dimension(s)
//       System.Int32[][]: 1 dimension(s)
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(s)
'       System.Int32[,]: 2 dimension(s)
'       System.Int32[][]: 1 dimension(s)

Comentários

Por exemplo, o código a seguir cria uma matriz de três dimensões com uma Rank propriedade cujo valor é 3.

Dim TDArray(0,0,0) As Integer
int[,,] TDArray = new int[1,1,1];

Uma matriz irregular (uma matriz de matrizes) é uma matriz unidimensional; o valor de sua Rank propriedade é 1.

A recuperação do valor dessa propriedade é uma operação O(1).

Aplica-se a

Confira também