Array.Length Propriété

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

Array.CoreCLR.cs

Obtient le nombre total d’éléments dans toutes les dimensions du Array.

C#

public int Length { get; }

Valeur de propriété

Int32

Nombre total d’éléments dans toutes les dimensions du Array ; zéro si le tableau ne contient pas d’élément.

Exceptions

OverflowException

Le tableau est multidimensionnel et contient plus d’éléments Int32.MaxValue .

Exemples

L’exemple suivant utilise la Length propriété pour obtenir le nombre total d’éléments dans un tableau. Il utilise également la GetUpperBound méthode pour déterminer le nombre d’éléments dans chaque dimension d’un tableau multidimensionnel.

C#

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

Remarques

La récupération de la valeur de cette propriété est une opération O(1).

S’applique à

Voir aussi

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