List<T>.AddRange(IEnumerable<T>) Methode

Definitie

Naamruimte:
System.Collections.Generic
Assembly's:
mscorlib.dll, System.Collections.dll
Assembly:
mscorlib.dll
Assembly:
System.Collections.dll
Assembly:
netstandard.dll

Voegt de elementen van de opgegeven verzameling toe aan het einde van de List<T>verzameling.

public:
 void AddRange(System::Collections::Generic::IEnumerable<T> ^ collection);
public void AddRange(System.Collections.Generic.IEnumerable<T> collection);
member this.AddRange : seq<'T> -> unit
Public Sub AddRange (collection As IEnumerable(Of T))

Parameters

collection
IEnumerable<T>

De verzameling waarvan de elementen aan het einde van de List<T>verzameling moeten worden toegevoegd. De verzameling zelf kan niet zijn null, maar kan elementen bevatten die null, als het type T een verwijzingstype is.

Uitzonderingen

ArgumentNullException

collection is null.

Voorbeelden

In het volgende voorbeeld ziet u de AddRange methode en verschillende andere methoden van de List<T> klasse die op bereiken reageren. Er wordt een matrix met tekenreeksen gemaakt en doorgegeven aan de constructor, waarbij de lijst wordt gevuld met de elementen van de matrix. De AddRange methode wordt aangeroepen, met de lijst als argument. Het resultaat is dat de huidige elementen van de lijst worden toegevoegd aan het einde van de lijst, waarbij alle elementen worden gedupliceerd.

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

Opmerkingen

De volgorde van de elementen in de verzameling blijft behouden in de List<T>.

Als de nieuwe Count (de huidige Count plus de grootte van de verzameling) groter is dan Capacity, wordt de capaciteit van de List<T> verzameling verhoogd door de interne matrix automatisch opnieuw in te stellen voor de nieuwe elementen en worden de bestaande elementen gekopieerd naar de nieuwe matrix voordat de nieuwe elementen worden toegevoegd.

Als de List<T> nieuwe elementen geschikt zijn zonder de Capacitynieuwe elementen te vergroten, is deze methode een O(n)-bewerking, waarbij n het aantal elementen is dat moet worden toegevoegd. Als de capaciteit moet worden verhoogd voor de nieuwe elementen, wordt deze methode een O(n + m)-bewerking, waarbij n het aantal elementen is dat moet worden toegevoegd en m is Count.

Van toepassing op

Zie ook