List<T>.InsertRange(Int32, IEnumerable<T>) Methode

Definition

Namespace:
System.Collections.Generic
Assemblys:
mscorlib.dll, System.Collections.dll
Assemblys:
netstandard.dll, System.Collections.dll
Assembly:
System.Collections.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
List.cs
Quelle:
List.cs
Quelle:
List.cs
Quelle:
List.cs
Quelle:
List.cs

Fügt die Elemente einer Auflistung in den List<T> angegebenen Index ein.

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

Parameter

index
Int32

Der nullbasierte Index, an dem die neuen Elemente eingefügt werden sollen.

collection
IEnumerable<T>

Die Auflistung, deren Elemente in die List<T>Auflistung eingefügt werden sollen. Die Auflistung selbst kann nicht seinnull, aber sie kann Elemente enthalten, die ein null Verweistyp sindT.

Ausnahmen

ArgumentNullException

collection ist null.

ArgumentOutOfRangeException

index ist kleiner als 0.

-oder-

index ist größer als Count.

Beispiele

Das folgende Beispiel veranschaulicht InsertRange die Methode und verschiedene andere Methoden der Klasse, die List<T> auf Bereiche reagieren. Nachdem die Liste erstellt und mit den Namen mehrerer friedlicher Pflanzenessen-Dinosaurier aufgefüllt wurde, wird die InsertRange Methode verwendet, um ein Array von drei wilden Fleisch-essenden Dinosauriern in die Liste einzufügen, beginnend am Indexstandort 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

Hinweise

List<T> akzeptiert null als gültiger Wert für Bezugstypen und lässt doppelte Elemente zu.

Wenn das neue Count (aktuelle Count Plus der Größe der Auflistung) größer Capacityals ist, wird die Kapazität des List<T> Objekts erhöht, indem das interne Array automatisch neu zugeordnet wird, um die neuen Elemente aufzunehmen, und die vorhandenen Elemente werden in das neue Array kopiert, bevor die neuen Elemente hinzugefügt werden.

Ist index gleich Count, werden die Elemente am Ende von List<T>.

Die Reihenfolge der Elemente in der Auflistung wird in der List<T>.

Diese Methode ist ein O(n * m)-Vorgang, wobei n die Anzahl der hinzuzufügenden Elemente und m ist Count.

Gilt für:

Weitere Informationen