閱讀英文

共用方式為

ArrayList.AddRange(ICollection) 方法

  • 參考

定義

命名空間:
System.Collections
組件:
mscorlib.dll, System.Collections.NonGeneric.dll
組件:
System.Runtime.dll
組件:
System.Collections.NonGeneric.dll
組件:
System.Runtime.Extensions.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
ArrayList.cs
來源:
ArrayList.cs
來源:
ArrayList.cs

將 ICollection 的項目加入 ArrayList 的結尾。

public virtual void AddRange (System.Collections.ICollection c);

參數

c
ICollection

ICollection，其項目應加入 ArrayList 的結尾。 集合本身不能是 null，但它可以包含為 null 的項目。

例外狀況

ArgumentNullException

c 為 null。

NotSupportedException

ArrayList 為唯讀。

-或-

ArrayList 具有固定的大小。

範例

下列程式代碼範例示範如何將專案新增至 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
*/

備註

ArrayList 接受 null 為有效值，並允許重複的專案。

中的 ICollection 項目順序會保留在 中 ArrayList。

如果新的 Count (目前 Count 加上集合大小) 大於 Capacity，則會藉由自動重新配置內部數位以容納新元素來增加的容量 ArrayList ，而現有的元素會在新增專案之前複製到新的數位。

ArrayList如果 可以容納新元素而不增加 Capacity，這個方法就是O(n)作業，其中 n 是要加入的項目數目。 如果需要增加容量以容納新的元素，這個方法就會 O(n + m) 變成作業，其中 n 是要新增的項目數目，而 m 是 Count。

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

另請參閱