ArrayList.AddRange(ICollection) Methode

Definitie

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

Voegt de elementen van een ICollection aan het einde van de ArrayList.

public:
 virtual void AddRange(System::Collections::ICollection ^ c);
public virtual void AddRange(System.Collections.ICollection c);
abstract member AddRange : System.Collections.ICollection -> unit
override this.AddRange : System.Collections.ICollection -> unit
Public Overridable Sub AddRange (c As ICollection)

Parameters

c
ICollection

De ICollection elementen waarvan de elementen moeten worden toegevoegd aan het einde van de ArrayList. De verzameling zelf kan niet zijn null, maar kan elementen bevatten die wel zijn null.

Uitzonderingen

ArgumentNullException

c is null.

NotSupportedException

Het ArrayList is alleen-lezen.

– of –

De ArrayList heeft een vaste grootte.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u elementen toevoegt aan de ArrayList.

using System;
using System.Collections;
public class SamplesArrayList  {

   public static void Main()  {

      // Creates and initializes a new ArrayList.
      ArrayList myAL = new ArrayList();
      myAL.Add( "The" );
      myAL.Add( "quick" );
      myAL.Add( "brown" );
      myAL.Add( "fox" );

      // Creates and initializes a new Queue.
      Queue myQueue = new Queue();
      myQueue.Enqueue( "jumps" );
      myQueue.Enqueue( "over" );
      myQueue.Enqueue( "the" );
      myQueue.Enqueue( "lazy" );
      myQueue.Enqueue( "dog" );

      // Displays the ArrayList and the Queue.
      Console.WriteLine( "The ArrayList initially contains the following:" );
      PrintValues( myAL, '\t' );
      Console.WriteLine( "The Queue initially contains the following:" );
      PrintValues( myQueue, '\t' );

      // Copies the Queue elements to the end of the ArrayList.
      myAL.AddRange( myQueue );

      // Displays the ArrayList.
      Console.WriteLine( "The ArrayList now contains the following:" );
      PrintValues( myAL, '\t' );
   }

   public static void PrintValues( IEnumerable myList, char mySeparator )  {
      foreach ( Object obj in myList )
         Console.Write( "{0}{1}", mySeparator, obj );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

The ArrayList initially contains the following:
    The    quick    brown    fox
The Queue initially contains the following:
    jumps    over    the    lazy    dog
The ArrayList now contains the following:
    The    quick    brown    fox    jumps    over    the    lazy    dog
*/

Imports System.Collections

Public Class SamplesArrayList    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new ArrayList.
        Dim myAL As New ArrayList()
        myAL.Add("The")
        myAL.Add("quick")
        myAL.Add("brown")
        myAL.Add("fox")
        
        ' Creates and initializes a new Queue.
        Dim myQueue As New Queue()
        myQueue.Enqueue("jumps")
        myQueue.Enqueue("over")
        myQueue.Enqueue("the")
        myQueue.Enqueue("lazy")
        myQueue.Enqueue("dog")
        
        ' Displays the ArrayList and the Queue.
        Console.WriteLine("The ArrayList initially contains the following:")
        PrintValues(myAL, ControlChars.Tab)
        Console.WriteLine("The Queue initially contains the following:")
        PrintValues(myQueue, ControlChars.Tab)
        
        ' Copies the Queue elements to the end of the ArrayList.
        myAL.AddRange(myQueue)
        
        ' Displays the ArrayList.
        Console.WriteLine("The ArrayList now contains the following:")
        PrintValues(myAL, ControlChars.Tab)
    End Sub

    Public Shared Sub PrintValues(myList As IEnumerable, mySeparator As Char)
        Dim obj As [Object]
        For Each obj In  myList
          Console.Write( "{0}{1}", mySeparator, obj )
        Next obj
        Console.WriteLine()
    End Sub

End Class


' This code produces the following output.
' 
' The ArrayList initially contains the following:
'     The    quick    brown    fox
' The Queue initially contains the following:
'     jumps    over    the    lazy    dog
' The ArrayList now contains the following:
'     The    quick    brown    fox    jumps    over    the    lazy    dog

Opmerkingen

ArrayList null accepteert als een geldige waarde en staat dubbele elementen toe.

De volgorde van de elementen in de ICollection elementen blijft behouden in de ArrayList.

Als de nieuwe Count (de huidige Count plus de grootte van de verzameling) groter is dan Capacity, wordt de capaciteit van de ArrayList 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 ArrayList nieuwe elementen geschikt zijn zonder de Capacitynieuwe elementen te vergroten, is deze methode een O(n) bewerking, waarbij n het aantal elementen dat moet worden toegevoegd. Als de capaciteit moet worden verhoogd om ruimte te bieden aan de nieuwe elementen, wordt deze methode een O(n + m) bewerking, waarbij n het aantal elementen dat moet worden toegevoegd en m is Count.

Van toepassing op

Zie ook