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

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Source:

List.cs

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

C#

public System.Collections.Generic.List<T> GetRange (int index, int count);

Paramètres

index

Int32

Index de base zéro List<T> où débute la plage.

count

Int32

Nombre d'éléments dans la plage.

Retours

List<T>

Copie superficielle d'une plage d'éléments de la source List<T>.

Exceptions

ArgumentOutOfRangeException

index est inférieur à 0.

- ou -

count est inférieur à 0.

ArgumentException

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

Exemples

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

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

Une copie superficielle d’une collection de types de 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 dans la nouvelle liste pointent vers 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 dans les éléments de la nouvelle collection pointent vers les mêmes objets que les références dans les éléments de la collection d’origine.

En revanche, une copie approfondie 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 count.

S’applique à

Voir aussi

• RemoveRange(Int32, Int32)
• AddRange(IEnumerable<T>)
• InsertRange(Int32, IEnumerable<T>)