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

Definición

Espacio de nombres:
System.Collections.Generic
Ensamblados:
mscorlib.dll, System.Collections.dll
Ensamblado:
mscorlib.dll
Ensamblado:
System.Collections.dll
Ensamblado:
netstandard.dll

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

public:
 void InsertRange(int index, System::Collections::Generic::IEnumerable<T> ^ collection);
public void InsertRange(int index, System.Collections.Generic.IEnumerable<T> collection);
member this.InsertRange : int * seq<'T> -> unit
Public Sub InsertRange (index As Integer, collection As IEnumerable(Of T))

Parámetros

index
Int32

Índice de base cero en el que 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 son 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 InsertRange el 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 pacíficos 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.

using System;
using System.Collections.Generic;

string[] input = { "Apple",
                   "Banana",
                   "Orange" };

List<string> fruits = new List<string>(input);

Console.WriteLine("\nCapacity: {0}", fruits.Capacity);
Console.WriteLine();

foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

Console.WriteLine("\nAddRange(fruits)");
fruits.AddRange(fruits);

Console.WriteLine();
foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

Console.WriteLine("\nRemoveRange(2, 2)");
fruits.RemoveRange(2, 2);

Console.WriteLine();
foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

input = new string[] { "Mango",
                       "Pineapple",
                       "Watermelon" };

Console.WriteLine("\nInsertRange(3, input)");
fruits.InsertRange(3, input);

Console.WriteLine();
foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

Console.WriteLine("\noutput = fruits.GetRange(2, 3).ToArray()");
string[] output = fruits.GetRange(2, 3).ToArray();

Console.WriteLine();
foreach (string fruit in output)
{
    Console.WriteLine(fruit);
}

/*
    This code example produces the following output:

    Capacity: 3

    Apple
    Banana
    Orange

    AddRange(fruits)

    Apple
    Banana
    Orange
    Apple
    Banana
    Orange

    RemoveRange(2, 2)

    Apple
    Banana
    Banana
    Orange

    InsertRange(3, input)

    Apple
    Banana
    Banana
    Mango
    Pineapple
    Watermelon
    Orange

    output = fruits.GetRange(2, 3).ToArray()

    Banana
    Mango
    Pineapple
*/

Imports System.Collections.Generic

Partial Public Class Program
    Public Shared Sub ShowFruits()

        Dim input() As String = { "Apple", _
                                  "Banana", _
                                  "Orange" }

        Dim fruits As New List(Of String)(input)

        Console.WriteLine(vbLf & "Capacity: {0}", fruits.Capacity)
        Console.WriteLine()

        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        Console.WriteLine(vbLf & "AddRange(fruits)")
        fruits.AddRange(fruits)

        Console.WriteLine()
        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        Console.WriteLine(vbLf & "RemoveRange(2, 2)")
        fruits.RemoveRange(2, 2)

        Console.WriteLine()
        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        input = New String() { "Mango", _
                               "Pineapple", _
                               "Watermelon" }

        Console.WriteLine(vbLf & "InsertRange(3, input)")
        fruits.InsertRange(3, input)

        Console.WriteLine()
        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        Console.WriteLine(vbLf & "output = fruits.GetRange(2, 3).ToArray")
        Dim output() As String = fruits.GetRange(2, 3).ToArray()

        Console.WriteLine()
        For Each fruit As String In output
            Console.WriteLine(fruit)
        Next

    End Sub
End Class

' This code example produces the following output:
'
' Capacity: 3
'
' Apple
' Banana
' Orange
'
' AddRange(fruits)
'
' Apple
' Banana
' Orange
' Apple
' Banana
' Orange
'
' RemoveRange(2, 2)
'
' Apple
' Banana
' Banana
' Orange
'
' InsertRange(3, input)
'
' Apple
' Banana
' Banana
' Mango
' Pineapple
' Watermelon
' Orange
'
' output = fruits.GetRange(2, 3).ToArray
'
' Banana
' Mango
' Pineapple

Comentarios

List<T> acepta null 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 List<T> 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 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 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