Array.Length Propriedade

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

Array.CoreCLR.cs

Obtém o número total de elementos em todas as dimensões do Array.

public int Length { get; }

Valor da propriedade

Int32

O número total de elementos em todas as dimensões do Array; zero se não houver elementos na matriz.

Exceções

OverflowException

A matriz é multidimensional e contém mais de elementos Int32.MaxValue .

Exemplos

O exemplo a seguir usa a Length propriedade para obter o número total de elementos em uma matriz. Ele também usa o GetUpperBound método para determinar o número de elementos em cada dimensão de uma matriz multidimensional.

using System;

public class Example
{
    public static void Main()
    {
        // Declare a single-dimensional string array
        String[] array1d = { "zero", "one", "two", "three" };
        ShowArrayInfo(array1d);

        // Declare a two-dimensional string array
        String[,] array2d = { { "zero", "0" }, { "one", "1" },
                           { "two", "2" }, { "three", "3"},
                           { "four", "4" }, { "five", "5" } };
        ShowArrayInfo(array2d);

        // Declare a three-dimensional integer array
        int[, ,] array3d = new int[,,] { { { 1, 2, 3 }, { 4, 5, 6 } },
                                       { { 7, 8, 9 }, { 10, 11, 12 } } };
        ShowArrayInfo(array3d);
    }

    private static void ShowArrayInfo(Array arr)
    {
        Console.WriteLine("Length of Array:      {0,3}", arr.Length);
        Console.WriteLine("Number of Dimensions: {0,3}", arr.Rank);
        // For multidimensional arrays, show number of elements in each dimension.
        if (arr.Rank > 1) {
            for (int dimension = 1; dimension <= arr.Rank; dimension++)
                Console.WriteLine("   Dimension {0}: {1,3}", dimension,
                                  arr.GetUpperBound(dimension - 1) + 1);
        }
        Console.WriteLine();
    }
}
// The example displays the following output:
//       Length of Array:        4
//       Number of Dimensions:   1
//
//       Length of Array:       12
//       Number of Dimensions:   2
//          Dimension 1:   6
//          Dimension 2:   2
//
//       Length of Array:       12
//       Number of Dimensions:   3
//          Dimension 1:   2
//          Dimension 2:   2
//          Dimension 3:   3

Comentários

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

Aplica-se a

Confira também

• GetLength(Int32)
• GetUpperBound(Int32)
• GetLowerBound(Int32)
• LongLength
• Count
• Rank