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

CKTIS / C#

List<T> — une liste générique redimensionnable

List<T> de System.Collections.Generic stocke des éléments d’un type spécifié dans une collection ordonnée et modifiable. La méthode Add ajoute un élément à la fin, tandis que la propriété Count indique le nombre actuel d’éléments, et non la capacité de la liste.

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

Syntaxe

List<T> items = new List<T>();
items.Add(value);
int count = items.Count;
T first = items[0];

List<T> de System.Collections.Generic est une liste modifiable fondée sur un tableau, dont la capacité augmente selon les besoins. Le paramètre T définit le type des éléments, par exemple List<string>. La liste autorise les doublons et ne trie pas automatiquement les éléments. Les index commencent à zéro ; la plage valide est 0 <= index < Count.

List<T>.Add(T item) ajoute un élément à la fin et renvoie void. Après un ajout réussi, Count augmente de un. Si de la capacité est disponible, l’opération a un coût O(1) ; si le tableau doit être agrandi et les éléments existants copiés, son coût est O(n), où n correspond à la valeur précédente de Count.

List<T>.Count est une propriété int en lecture seule, accessible sans parenthèses : names.Count. Sa lecture a un coût O(1). Count désigne le nombre d’éléments stockés, tandis que Capacity désigne le nombre d’éléments pouvant tenir sans redimensionner le tableau. new List<string>(4) crée une liste vide pouvant accueillir quatre éléments ; cela ne crée pas quatre éléments.

L’exemple présente une liste vide, trois appels à Add, un doublon et un accès par index. Ces API sont disponibles dans .NET 10 et ne nécessitent aucune fonctionnalité du langage en préversion. Si une liste est modifiée et partagée entre plusieurs threads, une synchronisation est nécessaire ; les membres d’instance ne garantissent pas la sécurité des threads.

Exemples

using System;
using System.Collections.Generic;

internal static class Program
{
    private static void Main()
    {
        List<string> names = new List<string>(4);
        Console.WriteLine($"Count: {names.Count}");

        names.Add("Ada");
        names.Add("Linus");
        names.Add("Ada");

        Console.WriteLine($"Count: {names.Count}");
        Console.WriteLine($"First: {names[0]}");
        Console.WriteLine(string.Join(", ", names));
    }
}

Résultat

Count: 0
Count: 3
First: Ada
Ada, Linus, Ada

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