Cette documentation est archivée et n’est pas conservée.

List<T>.GetRange, méthode

Mise à jour : November 2007

Crée une copie superficielle d'une plage d'éléments dans la source List<T>.

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

public List<T> GetRange(
	int index,
	int count
)
public List<T> GetRange(
	int index,
	int count
)
public function GetRange(
	index : int, 
	count : int
) : List<T>

Paramètres

index
Type : System.Int32
Index de base zéro List<T> auquel la plage commence.
count
Type : System.Int32
Nombre d'éléments dans la plage.

Valeur de retour

Type : System.Collections.Generic.List<T>
Copie superficielle d'une plage d'éléments dans la source List<T>.

ExceptionCondition
ArgumentOutOfRangeException

index est inférieur à 0.

– ou –

count est inférieur à 0.

ArgumentException

index et count ne désignent pas une plage valide d'éléments dans List<T>.

Une copie superficielle d'une collection de types référence, ou un sous-ensemble de cette collection, contient uniquement les références aux éléments de la collection. Les objets eux-mêmes ne sont pas copiés. Les références de la nouvelle liste désignent les mêmes objets que les références de la liste d'origine.

Une copie superficielle d'une collection de types valeur, ou un sous-ensemble de cette collection, contient les éléments de la collection. Toutefois, si les éléments de la collection contiennent des références à d'autres objets, ces objets ne sont pas copiés. Les références des éléments de la nouvelle collection désignent les mêmes objets que les références des éléments de la collection d'origine.

Par opposition, une copie complète d'une collection copie les éléments et tout ce qui est référencé directement ou indirectement par les éléments.

Cette méthode est une opération O(n), où n est égal à count.

L'exemple de code suivant illustre la méthode GetRange et d'autres méthodes de la classe List<T> qui agissent sur les plages. À la fin de l'exemple de code, la méthode GetRange est utilisée pour obtenir trois éléments de la liste, en commençant par l'emplacement d'index 2. La méthode ToArray est appelée sur le List<T> résultant, créant un tableau de trois éléments. Les éléments du tableau s'affichent.

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


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

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

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0

XNA Framework

Pris en charge dans : 2.0, 1.0
Afficher: