Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Array.Length — nombre d’éléments du tableau

Array.Length renvoie le nombre d’éléments d’un tableau sous forme de int. Pour un tableau multidimensionnel, il inclut toutes les dimensions ; pour un tableau vide, sa valeur est 0.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

public int Length { get; }

array.Length

Array.Length est une propriété en lecture seule : utilisez array.Length, sans parenthèses d’appel. Sa lecture est une opération de complexité O(1).

La longueur désigne le nombre d’emplacements d’éléments, et non le nombre de valeurs non nulles. Un tableau a une taille fixe : new int[3] a une longueur de 3, même s’il ne contient initialement que des zéros.

Pour new int[2, 3], Length vaut 6. Ne le confondez pas avec Rank, le nombre de dimensions. GetLength(0) et GetLength(1) renvoient les tailles de chaque dimension : 2 et 3.

Si un tableau multidimensionnel contient plus de Int32.MaxValue éléments, la lecture de Length déclenche une OverflowException. LongLength expose le nombre total d’éléments sous la forme d’un entier 64 bits.

Exemples

using System;

int[] values = new int[3];
int[,] grid = new int[2, 3];

Console.WriteLine(values.Length);
Console.WriteLine(grid.Length);
Console.WriteLine(grid.GetLength(0));
Console.WriteLine(grid.GetLength(1));
Console.WriteLine(new int[0].Length);

Résultat

3
6
2
3
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources