【C#學習筆記】 List.AddRange 方法

標籤：asi   color   大小   strong   ann   程式   rac   lin   city   

[官方筆記]

將指定集合的元素添加到 List 的末尾

命名空間:System.Collections.Generic
程式集:mscorlib（在 mscorlib.dll 中）

public:void AddRange 
(　　IEnumerable<T>^ collection)

collection ： 一個集合，其元素應被添加到 List 的末尾。集合自身不能為 Null 參考（在 Visual Basic 中為 Nothing），

　　　　　　但它可以包含為 Null 參考（在 Visual Basic 中為 Nothing） 的元素（如果類型 T 為參考型別）。

 

備忘：  List 中會保留集合中元素的順序。

如果新的 Count（當前 Count 加上集合的大小）大於 Capacity，則會通過自動重新分配內部數組增大 List 的容量以容納新元素，並在添加新元素之前將現有元素複製到新數組中。

如果 List 可以在不增加 Capacity 的情況下容納新元素，則此方法是 O(n) 運算，其中 n 是要添加的元素數。如果需要增加此容量以容納新元素，則此方法變為 O(n + m) 運算，其中 n 是要添加的元素數，m 是 Count。

樣本：

using System;using System.Collections.Generic;public class Example{    public static void Main()    {        string[] input = { "Brachiosaurus",                            "Amargasaurus",                            "Mamenchisaurus" };        List<string> dinosaurs = new List<string>(input);        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);        Console.WriteLine();        foreach( string dinosaur in dinosaurs )        {            Console.WriteLine(dinosaur);        }        Console.WriteLine("\nAddRange(dinosaurs)");        dinosaurs.AddRange(dinosaurs);        Console.WriteLine();        foreach( string dinosaur in dinosaurs )        {            Console.WriteLine(dinosaur);        }        Console.WriteLine("\nRemoveRange(2, 2)");        dinosaurs.RemoveRange(2, 2);        Console.WriteLine();        foreach( string dinosaur in dinosaurs )        {            Console.WriteLine(dinosaur);        }        input = new string[] { "Tyrannosaurus",                                "Deinonychus",                                "Velociraptor"};        Console.WriteLine("\nInsertRange(3, input)");        dinosaurs.InsertRange(3, input);        Console.WriteLine();        foreach( string dinosaur in dinosaurs )        {            Console.WriteLine(dinosaur);        }        Console.WriteLine("\noutput = dinosaurs.GetRange(2, 3).ToArray()");        string[] output = dinosaurs.GetRange(2, 3).ToArray();                Console.WriteLine();        foreach( string dinosaur in output )        {            Console.WriteLine(dinosaur);        }    }}

 

 

 

 

【C#學習筆記】 List.AddRange 方法