Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

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

 

Date de publication : novembre 2016

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

Espace de noms:   System.Collections.Generic
Assembly:  mscorlib (dans mscorlib.dll)

public void InsertRange(
	int index,
	IEnumerable<T> collection
)

Paramètres

index
Type: System.Int32

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

collection
Type: System.Collections.Generic.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.

Exception Condition
ArgumentNullException

collection a la valeur null.

ArgumentOutOfRangeException

index est inférieur à 0.

ou

index est supérieur à Count.

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

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

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

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

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

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

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
 */

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: