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

Definición

Espacio de nombres:

System.Collections.Generic

Ensamblado:

System.Collections.dll

Source:

List.cs

Inserta los elementos de una colección en List<T> en el índice especificado.

C#

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

Parámetros

index

Int32

Índice de base cero donde se deben insertar los nuevos elementos.

collection

IEnumerable<T>

Colección cuyos elementos se deben insertar en List<T>. La propia colección no puede ser null, pero puede contener elementos que sean null si el tipo T es un tipo de referencia.

Excepciones

ArgumentNullException

collection es null.

ArgumentOutOfRangeException

index es menor que 0.

O bien

index es mayor que Count.

Ejemplos

En el ejemplo siguiente se muestra el InsertRange método y otros métodos de la List<T> clase que actúan en intervalos. Una vez creada y rellenada la lista con los nombres de varios dinosaurios tranquilos que comen plantas, el InsertRange método se utiliza para insertar una matriz de tres dinosaurios feroces que comen carne en la lista, comenzando en la ubicación del índice 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
 */

Comentarios

List<T> null acepta como un valor válido para los tipos de referencia y permite elementos duplicados.

Si el nuevo (el actual CountCount más el tamaño de la colección) será mayor que Capacity, la capacidad de se incrementa mediante la reasignación automática de la matriz interna para acomodar los nuevos elementos y los elementos existentes se copian en la nueva matriz antes de List<T> agregar los nuevos elementos.

Si index es igual a Count, los elementos se agregan al final de List<T>.

El orden de los elementos de la colección se conserva en .List<T>

Este método es una operación de O(n * m), donde n es el número de elementos que se van a agregar y m es Count.

Se aplica a

Consulte también

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