Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

List<T>.InsertRange, méthode

Insère les éléments d'une collection List<T> à 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 devraient être insérés dans List<T>. La collection elle-même ne peut pas être null, mais elle peut contenir des éléments qui sont null, si le type T est un type référence.

ExceptionCondition
ArgumentNullException

collection a la valeur null.

ArgumentOutOfRangeException

index est inférieur à 0.

ou

index est supérieur à Count.

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

Si le nouveau Count (le Count actuel plus la taille de la collection) sera supérieur à Capacity, la capacité du List<T> est augmentée en réallouant automatiquement le tableau interne ; en outre, les éléments existants sont copiés dans le nouveau tableau avant que le nouvel élément soit ajouté.

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 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.

L'exemple suivant illustre la méthode InsertRange et de nombreuses autres méthodes de la classe List<T> qui agissent sur des plages. Une fois la liste créée et remplie avec les noms de plusieurs dinosaures herbivores paisibles, la méthode InsertRange est utilisée pour insérer un tableau de trois dinosaures carnivores 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
 */


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft