ArrayList.InsertRange(Int32, ICollection) 方法

定義

命名空間:

System.Collections

組件:

System.Runtime.dll

來源:

ArrayList.cs

將集合的項目插入位於指定索引的 ArrayList 中。

public virtual void InsertRange (int index, System.Collections.ICollection c);

參數

index

Int32

應插入新項目處的以零為起始的索引。

c

ICollection

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

例外狀況

ArgumentNullException

c 為 null。

ArgumentOutOfRangeException

index 小於零。

-或-

index 大於 Count。

NotSupportedException

ArrayList 為唯讀。

-或-

ArrayList 具有固定的大小。

範例

下列程式代碼範例示範如何將專案 ArrayList插入 。

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

   public static void Main()  {

      // Creates and initializes a new ArrayList using Insert instead of Add.
      ArrayList myAL = new ArrayList();
      myAL.Insert( 0, "The" );
      myAL.Insert( 1, "fox" );
      myAL.Insert( 2, "jumps" );
      myAL.Insert( 3, "over" );
      myAL.Insert( 4, "the" );
      myAL.Insert( 5, "dog" );

      // Creates and initializes a new Queue.
      Queue myQueue = new Queue();
      myQueue.Enqueue( "quick" );
      myQueue.Enqueue( "brown" );

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

      // Copies the Queue elements to the ArrayList at index 1.
      myAL.InsertRange( 1, myQueue );

      // Displays the ArrayList.
      Console.WriteLine( "After adding the Queue, the ArrayList now contains:" );
      PrintValues( myAL );

      // Search for "dog" and add "lazy" before it.
      myAL.Insert( myAL.IndexOf( "dog" ), "lazy" );

      // Displays the ArrayList.
      Console.WriteLine( "After adding \"lazy\", the ArrayList now contains:" );
      PrintValues( myAL );

      // Add "!!!" at the end.
      myAL.Insert( myAL.Count, "!!!" );

      // Displays the ArrayList.
      Console.WriteLine( "After adding \"!!!\", the ArrayList now contains:" );
      PrintValues( myAL );

      // Inserting an element beyond Count throws an exception.
      try  {
         myAL.Insert( myAL.Count+1, "anystring" );
      } catch ( Exception myException )  {
         Console.WriteLine("Exception: " + myException.ToString());
      }
   }

   public static void PrintValues( IEnumerable myList )  {
      foreach ( Object obj in myList )
         Console.Write( "   {0}", obj );
      Console.WriteLine();
   }
}
/*
This code produces the following output.

The ArrayList initially contains the following:
   The   fox   jumps   over   the   dog
The Queue initially contains the following:
   quick   brown
After adding the Queue, the ArrayList now contains:
   The   quick   brown   fox   jumps   over   the   dog
After adding "lazy", the ArrayList now contains:
   The   quick   brown   fox   jumps   over   the   lazy   dog
After adding "!!!", the ArrayList now contains:
   The   quick   brown   fox   jumps   over   the   lazy   dog   !!!
Exception: System.ArgumentOutOfRangeException: Insertion index was out of range.  Must be non-negative and less than or equal to size.
Parameter name: index
   at System.Collections.ArrayList.Insert(int index, Object value)
   at SamplesArrayList.Main()
*/

備註

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

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

如果 index 等於 Count，則會將專案加入至 的 ArrayList結尾。

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

在連續項目的集合 (例如清單) 中，後面接著插入點的項目會向下移動以容納新項目。 如果集合具有索引，則移動之項目的索引也會更新。 集合的項目若在概念上群組成 Bucket (例如雜湊資料表)，則不適用這項行為。

這個方法是作業 O(n + m) ，其中 n 是要加入 m 且 為 Count的項目數目。

適用於

另請參閱

• Insert(Int32, Object)
• AddRange(ICollection)
• SetRange(Int32, ICollection)
• GetRange(Int32, Int32)
• RemoveRange(Int32, Int32)