HOWTO · Csharp

Copier une liste en C#

Il existe 2 méthodes principales qui peuvent être utilisées pour créer une copie séparée d'une liste en C#, la méthode linq et la méthode du constructeur de liste.

Sur cette page

Pour copier une liste C#, utilisez new List<T>(source) ou source.ToList() avec LINQ afin de créer une liste distincte contenant les mêmes éléments. Ces deux méthodes produisent une copie superficielle : elles ne créent pas de nouveaux objets pour les éléments de type référence. Utilisez AddRange pour ajouter des éléments à une liste de destination, GetRange pour copier une portion de liste, et une logique explicite de copie des éléments lorsque les objets eux-mêmes doivent être indépendants.

Copie superficielle et copie profonde

Une liste contient des emplacements pour ses éléments. Copier la liste crée un nouvel ensemble d’emplacements : ajouter ou supprimer un élément dans une liste ne modifie donc pas la structure de l’autre. Le comportement de chaque élément dépend de son type.

Pour les types valeur, comme int, chaque liste contient sa propre valeur. Pour les types référence, comme une classe Person personnalisée, chaque liste contient une référence. Une copie superficielle duplique ces références : les deux listes pointent donc vers les mêmes objets. Si vous modifiez les propriétés d’un objet de type référence depuis l’une ou l’autre liste, la modification est visible depuis les deux. En revanche, remplacer ou supprimer un emplacement dans une liste ne remplace ni ne supprime l’emplacement correspondant dans l’autre.

Une copie profonde crée aussi des copies indépendantes des objets référencés. Cela nécessite une règle de copie adaptée au type des éléments : aucune méthode standard de copie de liste ne peut déterminer comment dupliquer un objet arbitraire et son état imbriqué.

Copier une liste en C# avec le constructeur de liste

Le constructeur de liste permet directement de créer une nouvelle liste à partir d’une collection existante. Cet exemple utilise des chaînes et montre l’opération de copie de base.

Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var original = new List<string> { "Laptop", "Desktop", "Tablet" };
        var copy = new List<string>(original);

        original.Add("Phone");
        Console.WriteLine(string.Join(", ", copy));
    }
}

Le constructeur énumère les éléments de la source et les place dans une nouvelle liste. Dans cet exemple, copy conserve les trois entrées d’origine lorsqu’une autre entrée est ajoutée à original. Pour une liste d’éléments de type référence, la nouvelle liste contient toujours les mêmes références d’objet. Le constructeur accepte des collections de types valeur comme de types référence ; il ne se limite pas aux listes de types valeur.

Copier une liste en C# avec LINQ ToList

La méthode ToList() de LINQ matérialise un IEnumerable<T> sous la forme d’une nouvelle List<T>. Elle est utile lorsque la source est une requête ou un autre type énumérable, mais aussi lorsque la source est déjà une liste. Ajoutez using System.Linq; pour utiliser cette méthode d’extension.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.

using System;
using System.Collections.Generic;
using System.Linq;

class Program
{
    static void Main()
    {
        IEnumerable<string> source = new[] { "Chair", "Table", "Couch" };
        List<string> copy = source.ToList();
        Console.WriteLine(string.Join(", ", copy));
    }
}

ToList() crée un nouveau conteneur et y copie les éléments produits par l’énumérable. Si ces éléments sont des références vers des objets modifiables, la liste copiée contient les mêmes références. Si ce partage n’est pas souhaité, utilisez une opération de copie adaptée au type des éléments.

Copier une liste en C# avec List<T>.AddRange

AddRange ajoute à la fin de la liste sur laquelle elle est appelée tous les éléments d’un IEnumerable<T>. Pour créer une copie, commencez par créer la liste de destination, puis ajoutez-y les éléments de la source :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var original = new List<string> { "Chair", "Table", "Couch" };
        var copy = new List<string>();
        copy.AddRange(original);
        Console.WriteLine(string.Join(", ", copy));
    }
}

Ici, la liste de destination est initialement vide ; après l’appel à AddRange, elle contient donc la séquence de la source. Si la destination contient déjà des éléments, ils restent avant ceux qui sont ajoutés : AddRange ne remplace pas le contenu de la liste. Comme le constructeur, cette méthode copie les valeurs ou les références des éléments, et non les objets désignés par les éléments de type référence.

Copier une partie d’une liste avec List<T>.GetRange

Utilisez GetRange(index, count) pour créer une nouvelle liste contenant une portion consécutive. L’index commence à zéro et le nombre indique combien d’éléments inclure. Par exemple, l’index 1 et le nombre 3 sélectionnent les deuxième, troisième et quatrième éléments :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var original = new List<string> { "Chair", "Table", "Couch", "Lamp", "Rug" };
        List<string> segment = original.GetRange(1, 3);
        Console.WriteLine(string.Join(", ", segment));
    }
}

La plage demandée doit tenir dans la liste source : l’index et le nombre doivent être positifs ou nuls, et leur somme ne peut pas dépasser le nombre d’éléments de la liste. Sinon, GetRange lève une ArgumentOutOfRangeException. La liste renvoyée est un nouveau conteneur, mais les éléments de type référence de la portion désignent toujours les mêmes objets que dans la liste source.

Créer une copie profonde des éléments d’une liste

Il n’existe pas de méthode universelle item.Clone() pour les objets C# arbitraires, et l’implémentation de ICloneable ne garantit pas que Clone() effectue une copie profonde. Un type peut fournir son propre constructeur de copie ou sa propre méthode, mais c’est le comportement documenté qui détermine quels objets imbriqués sont copiés.

Pour un type connu, exprimez directement la règle de copie souhaitée. Par exemple, si Person possède un constructeur qui copie tous les champs nécessaires et crée les objets imbriqués indépendants requis, vous pouvez copier une liste avec people.Select(person => new Person(person)).ToList(). Cela nécessite using System.Linq; ainsi que l’implémentation, par l’application, du constructeur Person(Person other). Ce constructeur doit définir comment copier chaque membre ; copier directement une référence imbriquée maintiendrait le partage pour ce membre.

Choisissez une stratégie adaptée au modèle de données : il est souvent sûr de partager des objets immuables, tandis que les objets modifiables qui doivent être indépendants nécessitent une logique explicite de copie des éléments. Vérifiez le contrat de copie du type au lieu de supposer qu’une méthode nommée Clone duplique tout son graphe d’objets.

Choisir une méthode de copie de liste

  • Utilisez new List<T>(source) pour créer une copie directe et claire à partir d’une collection.
  • Utilisez source.ToList() pour matérialiser un énumérable ou lorsque la forme LINQ s’intègre bien à la requête environnante.
  • Utilisez destination.AddRange(source) pour ajouter les éléments de la source à une destination ; commencez par une nouvelle destination si elle doit contenir uniquement la séquence copiée.
  • Utilisez source.GetRange(index, count) pour copier une portion contiguë, en vérifiant que la plage demandée tient dans la source.
  • Utilisez une logique explicite de copie des éléments lorsque les objets de type référence doivent être indépendants. Une nouvelle liste ne sépare que la structure de la liste.