List<T>.InsertRange(Int32, IEnumerable<T>) Méthode

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Source:

List.cs

Insère les éléments d'une collection dans List<T> au niveau de l'index spécifié.

C#

public void InsertRange (int index, System.Collections.Generic.IEnumerable<T> collection);

Paramètres

index

Int32

Index de base zéro au niveau duquel les nouveaux éléments devraient être insérés.

collection

IEnumerable<T>

Collection dont les éléments doivent être insérés dans List<T>. La collection elle-même ne peut pas avoir la valeur null, mais elle peut contenir des éléments qui sont null, si le type T est un type référence.

Exceptions

ArgumentNullException

collection a la valeur null.

ArgumentOutOfRangeException

index est inférieur à 0.

-ou-

index est supérieur à Count.

Exemples

L’exemple suivant illustre InsertRange la méthode et diverses autres méthodes de la List<T> classe qui agissent sur des plages. Une fois la liste créée et remplie avec les noms de plusieurs dinosaures pacifiques mangeurs de plantes, la InsertRange méthode est utilisée pour insérer un tableau de trois dinosaures féroces mangeurs de viande dans la liste, en commençant à l’emplacement d’index 3.

C#

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        string[] input = { "Brachiosaurus",
                           "Amargasaurus",
                           "Mamenchisaurus" };

        List<string> dinosaurs = new List<string>(input);

        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nAddRange(dinosaurs)");
        dinosaurs.AddRange(dinosaurs);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nRemoveRange(2, 2)");
        dinosaurs.RemoveRange(2, 2);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        input = new string[] { "Tyrannosaurus",
                               "Deinonychus",
                               "Velociraptor"};

        Console.WriteLine("\nInsertRange(3, input)");
        dinosaurs.InsertRange(3, input);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\noutput = dinosaurs.GetRange(2, 3).ToArray()");
        string[] output = dinosaurs.GetRange(2, 3).ToArray();

        Console.WriteLine();
        foreach( string dinosaur in output )
        {
            Console.WriteLine(dinosaur);
        }
    }
}

/* This code example produces the following output:

Capacity: 3

Brachiosaurus
Amargasaurus
Mamenchisaurus

AddRange(dinosaurs)

Brachiosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Amargasaurus
Mamenchisaurus

RemoveRange(2, 2)

Brachiosaurus
Amargasaurus
Amargasaurus
Mamenchisaurus

InsertRange(3, input)

Brachiosaurus
Amargasaurus
Amargasaurus
Tyrannosaurus
Deinonychus
Velociraptor
Mamenchisaurus

output = dinosaurs.GetRange(2, 3).ToArray()

Amargasaurus
Tyrannosaurus
Deinonychus
 */

Remarques

List<T> accepte null comme valeur valide pour les types de référence et autorise les éléments en double.

Si le nouveau Count (l’actuel Count plus la taille de la collection) est supérieur Capacityà , la capacité du List<T> est augmentée en réaffectant automatiquement le tableau interne pour prendre en charge les nouveaux éléments, et les éléments existants sont copiés dans le nouveau tableau avant l’ajout des nouveaux éléments.

Si index est égal à Count, les éléments sont ajoutés à la fin de List<T>.

L’ordre des éléments de la collection est conservé dans .List<T>

Cette méthode est une opération O(n * m), où n est le nombre d’éléments à ajouter et m est Count.

S’applique à

Voir aussi

• Insert(Int32, T)
• AddRange(IEnumerable<T>)
• GetRange(Int32, Int32)
• RemoveRange(Int32, Int32)