List<T>.AddRange(IEnumerable<T>) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 컬렉션의 요소를 .의 List<T>끝에 추가합니다.
public:
void AddRange(System::Collections::Generic::IEnumerable<T> ^ collection);public void AddRange(System.Collections.Generic.IEnumerable<T> collection);member this.AddRange : seq<'T> -> unitPublic Sub AddRange (collection As IEnumerable(Of T))매개 변수
- collection
- IEnumerable<T>
요소를 해당 요소의 끝에 추가해야 하는 컬렉션입니다 List<T>. 컬렉션 자체는 사용할 null수 없지만 형식이 null참조 형식인 경우 T 해당 요소를 포함할 수 있습니다.
예외
collection은 null입니다.
예제
다음 예제에서는 범위에서 AddRange 작동하는 클래스의 List<T> 메서드 및 기타 다양한 메서드를 보여 줍니다. 문자열 배열이 만들어지고 생성자에 전달되어 목록이 배열의 요소로 채워집니다. 이 AddRange 메서드는 인수로 목록을 사용하여 호출됩니다. 그 결과 목록의 현재 요소가 목록 끝에 추가되어 모든 요소가 복제됩니다.
using System;
using System.Collections.Generic;
string[] input = { "Apple",
"Banana",
"Orange" };
List<string> fruits = new List<string>(input);
Console.WriteLine("\nCapacity: {0}", fruits.Capacity);
Console.WriteLine();
foreach (string fruit in fruits)
{
Console.WriteLine(fruit);
}
Console.WriteLine("\nAddRange(fruits)");
fruits.AddRange(fruits);
Console.WriteLine();
foreach (string fruit in fruits)
{
Console.WriteLine(fruit);
}
Console.WriteLine("\nRemoveRange(2, 2)");
fruits.RemoveRange(2, 2);
Console.WriteLine();
foreach (string fruit in fruits)
{
Console.WriteLine(fruit);
}
input = new string[] { "Mango",
"Pineapple",
"Watermelon" };
Console.WriteLine("\nInsertRange(3, input)");
fruits.InsertRange(3, input);
Console.WriteLine();
foreach (string fruit in fruits)
{
Console.WriteLine(fruit);
}
Console.WriteLine("\noutput = fruits.GetRange(2, 3).ToArray()");
string[] output = fruits.GetRange(2, 3).ToArray();
Console.WriteLine();
foreach (string fruit in output)
{
Console.WriteLine(fruit);
}
/*
This code example produces the following output:
Capacity: 3
Apple
Banana
Orange
AddRange(fruits)
Apple
Banana
Orange
Apple
Banana
Orange
RemoveRange(2, 2)
Apple
Banana
Banana
Orange
InsertRange(3, input)
Apple
Banana
Banana
Mango
Pineapple
Watermelon
Orange
output = fruits.GetRange(2, 3).ToArray()
Banana
Mango
Pineapple
*/
Imports System.Collections.Generic
Partial Public Class Program
Public Shared Sub ShowFruits()
Dim input() As String = { "Apple", _
"Banana", _
"Orange" }
Dim fruits As New List(Of String)(input)
Console.WriteLine(vbLf & "Capacity: {0}", fruits.Capacity)
Console.WriteLine()
For Each fruit As String In fruits
Console.WriteLine(fruit)
Next
Console.WriteLine(vbLf & "AddRange(fruits)")
fruits.AddRange(fruits)
Console.WriteLine()
For Each fruit As String In fruits
Console.WriteLine(fruit)
Next
Console.WriteLine(vbLf & "RemoveRange(2, 2)")
fruits.RemoveRange(2, 2)
Console.WriteLine()
For Each fruit As String In fruits
Console.WriteLine(fruit)
Next
input = New String() { "Mango", _
"Pineapple", _
"Watermelon" }
Console.WriteLine(vbLf & "InsertRange(3, input)")
fruits.InsertRange(3, input)
Console.WriteLine()
For Each fruit As String In fruits
Console.WriteLine(fruit)
Next
Console.WriteLine(vbLf & "output = fruits.GetRange(2, 3).ToArray")
Dim output() As String = fruits.GetRange(2, 3).ToArray()
Console.WriteLine()
For Each fruit As String In output
Console.WriteLine(fruit)
Next
End Sub
End Class
' This code example produces the following output:
'
' Capacity: 3
'
' Apple
' Banana
' Orange
'
' AddRange(fruits)
'
' Apple
' Banana
' Orange
' Apple
' Banana
' Orange
'
' RemoveRange(2, 2)
'
' Apple
' Banana
' Banana
' Orange
'
' InsertRange(3, input)
'
' Apple
' Banana
' Banana
' Mango
' Pineapple
' Watermelon
' Orange
'
' output = fruits.GetRange(2, 3).ToArray
'
' Banana
' Mango
' Pineapple
설명
컬렉션에 있는 요소의 순서는 에 List<T>유지됩니다.
새 Count 요소(컬렉션의 현재 Count 및 크기)가 보다 Capacity크면 새 요소를 수용하도록 내부 배열을 자동으로 다시 할당하여 용량 List<T> 이 증가하고 새 요소가 추가되기 전에 기존 요소가 새 배열에 복사됩니다.
List<T> 새 요소를 늘리Capacity지 않고 수용할 수 있는 경우 이 메서드는 O(n) 작업이며 여기서 n은 추가할 요소의 수입니다. 새 요소를 수용하기 위해 용량을 늘려야 하는 경우 이 메서드는 O(n + m) 작업이 됩니다. 여기서 n 은 추가할 요소의 수이고 m 은 입니다 Count.
