ArrayList.AddRange(ICollection) Metoda

Definice

Obor názvů:
System.Collections
Sestavení:
mscorlib.dll, System.Collections.NonGeneric.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.Collections.NonGeneric.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
ArrayList.cs
Zdroj:
ArrayList.cs
Zdroj:
ArrayList.cs
Zdroj:
ArrayList.cs
Zdroj:
ArrayList.cs

Přidá prvky na ICollection konec 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)

Parametry

c
ICollection

Jejíž ICollection prvky by měly být přidány na konec ArrayList. Samotná kolekce nemůže být null, ale může obsahovat prvky, které jsou null.

Výjimky

ArgumentNullException

c je null.

NotSupportedException

Je ArrayList jen pro čtení.

nebo

Má ArrayList pevnou velikost.

Příklady

Následující příklad kódu ukazuje, jak přidat elementy ArrayListdo .

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

Poznámky

ArrayList přijímá null jako platnou hodnotu a umožňuje duplicitní prvky.

Pořadíprvkůch ICollectionArrayList

Pokud bude nová Count (aktuální Count plus velikost kolekce) větší než Capacity, zvýší se kapacita objektu ArrayList automaticky přidělením interního pole tak, aby vyhovovala novým prvkům, a existující prvky se zkopírují do nového pole před přidáním nových prvků.

ArrayList Pokud lze přizpůsobit nové prvky bez zvýšení Capacity, tato metoda je O(n) operace, kde n je počet prvků, které mají být přidány. Pokud je potřeba zvýšit kapacitu tak, aby vyhovovala novým prvkům, stane se O(n + m) tato metoda operací, kde n je počet prvků, které mají být přidány a m je Count.

Platí pro

Viz také