다음을 통해 공유

List<T>.CopyTo 메서드

  • 참조

정의

네임스페이스:
System.Collections.Generic
어셈블리:
System.Collections.dll
어셈블리:
mscorlib.dll
어셈블리:
netstandard.dll

List<T>이나 그 일부를 배열에 복사합니다.

오버로드

CopyTo(T[], Int32)

대상 배열의 지정된 인덱스에서 시작하여 전체 List<T>을 호환되는 1차원 배열에 복사합니다.
CopyTo(Int32, T[], Int32, Int32)

대상 배열의 지정된 인덱스에서 시작하여 List<T>에 있는 일련의 요소를 호환되는 1차원 배열에 복사합니다.
CopyTo(T[])

대상 배열의 처음부터 시작하여 전체 List<T>을 호환되는 1차원 배열에 복사합니다.

예제

다음 예제에서는 메서드의 세 가지 오버로드를 CopyTo 모두 보여 줍니다. List<T> 문자열의 은 5개의 문자열로 만들어지고 채워집니다. 15개 요소의 빈 문자열 배열이 만들어지고 CopyTo(T[]) 메서드 오버로드를 사용하여 목록의 모든 요소를 배열의 첫 번째 요소부터 시작하는 배열로 복사합니다. CopyTo(T[], Int32) 메서드 오버로드는 목록의 모든 요소를 배열 인덱스 6에서 시작하는 배열로 복사하는 데 사용됩니다(인덱스 5는 비워 두기). 마지막으로 메서드 CopyTo(Int32, T[], Int32, Int32) 오버로드는 인덱스 2부터 시작하여 목록에서 배열 인덱스 12부터 시작하는 배열로 3개 요소를 복사하는 데 사용됩니다(인덱스 11은 비워 두기). 그런 다음 배열의 내용이 표시됩니다.

using namespace System;
using namespace System::Collections::Generic;

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();

    dinosaurs->Add("Tyrannosaurus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Brachiosaurus");
    dinosaurs->Add("Compsognathus");

    Console::WriteLine();
    for each(String^ dinosaurs in dinosaurs )
    {
        Console::WriteLine(dinosaurs);
    }

    // Create an array of 15 strings.
    array<String^>^ arr = gcnew array<String^>(15);

    dinosaurs->CopyTo(arr);
    dinosaurs->CopyTo(arr, 6);
    dinosaurs->CopyTo(2, arr, 12, 3);

    Console::WriteLine("\nContents of the array:");
    for each(String^ dinosaurs in arr )
    {
        Console::WriteLine(dinosaurs);
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Deinonychus
Tyrannosaurus
Compsognathus

IndexOf("Tyrannosaurus"): 0

IndexOf("Tyrannosaurus", 3): 5

IndexOf("Tyrannosaurus", 2, 2): -1
 */

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        dinosaurs.Add("Tyrannosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Mamenchisaurus");
        dinosaurs.Add("Brachiosaurus");
        dinosaurs.Add("Compsognathus");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        // Declare an array with 15 elements.
        string[] array = new string[15];

        dinosaurs.CopyTo(array);
        dinosaurs.CopyTo(array, 6);
        dinosaurs.CopyTo(2, array, 12, 3);

        Console.WriteLine("\nContents of the array:");
        foreach(string dinosaur in array)
        {
            Console.WriteLine(dinosaur);
        }
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Compsognathus

Contents of the array:
Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Compsognathus

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Compsognathus

Mamenchisaurus
Brachiosaurus
Compsognathus
 */

Imports System.Collections.Generic

Public Class Example

    Public Shared Sub Main()

        Dim dinosaurs As New List(Of String)

        dinosaurs.Add("Tyrannosaurus")
        dinosaurs.Add("Amargasaurus")
        dinosaurs.Add("Mamenchisaurus")
        dinosaurs.Add("Brachiosaurus")
        dinosaurs.Add("Compsognathus")

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        ' Declare an array with 15 elements (0 through 14).
        Dim array(14) As String

        dinosaurs.CopyTo(array)
        dinosaurs.CopyTo(array, 6)
        dinosaurs.CopyTo(2, array, 12, 3)

        Console.WriteLine(vbLf & "Contents of the array:")
        For Each dinosaur As String In array
            Console.WriteLine(dinosaur)
        Next

    End Sub
End Class

' This code example produces the following output:
'
'Tyrannosaurus
'Amargasaurus
'Mamenchisaurus
'Brachiosaurus
'Compsognathus
'
'Contents of the array:
'Tyrannosaurus
'Amargasaurus
'Mamenchisaurus
'Brachiosaurus
'Compsognathus
'
'Tyrannosaurus
'Amargasaurus
'Mamenchisaurus
'Brachiosaurus
'Compsognathus
'
'Mamenchisaurus
'Brachiosaurus
'Compsognathus

CopyTo(T[], Int32)

Source:
List.cs
Source:
List.cs
Source:
List.cs

대상 배열의 지정된 인덱스에서 시작하여 전체 List<T>을 호환되는 1차원 배열에 복사합니다.

public:
 virtual void CopyTo(cli::array <T> ^ array, int arrayIndex);
public void CopyTo (T[] array, int arrayIndex);
abstract member CopyTo : 'T[] * int -> unit
override this.CopyTo : 'T[] * int -> unit
Public Sub CopyTo (array As T(), arrayIndex As Integer)

매개 변수

array
T[]

Array에서 복사한 요소의 대상인 일차원 List<T>입니다. Array에는 0부터 시작하는 인덱스가 있어야 합니다.

arrayIndex
Int32

array에서 복사가 시작되는 0부터 시작하는 인덱스입니다.

구현

CopyTo(T[], Int32)

예외

ArgumentNullException

array이(가) null인 경우

ArgumentOutOfRangeException

arrayIndex 가 0보다 작습니다.

ArgumentException

소스 List<T>의 요소 수가 대상 array의 arrayIndex부터 끝까지 사용 가능한 공간보다 큽니다.

설명

이 메서드는 를 사용하여 Array.Copy 요소를 복사합니다.

요소는 열거자가 를 반복List<T>하는 순서와 동일한 순서로 에 복사 Array 됩니다.

이 메서드는 O(n) 작업이며 여기서 n 은 입니다 Count.

적용 대상

CopyTo(Int32, T[], Int32, Int32)

Source:
List.cs
Source:
List.cs
Source:
List.cs

대상 배열의 지정된 인덱스에서 시작하여 List<T>에 있는 일련의 요소를 호환되는 1차원 배열에 복사합니다.

public:
 void CopyTo(int index, cli::array <T> ^ array, int arrayIndex, int count);
public void CopyTo (int index, T[] array, int arrayIndex, int count);
member this.CopyTo : int * 'T[] * int * int -> unit
Public Sub CopyTo (index As Integer, array As T(), arrayIndex As Integer, count As Integer)

매개 변수

index
Int32

소스 List<T>에서 복사가 시작되는 인덱스(0부터 시작)입니다.

array
T[]

Array에서 복사한 요소의 대상인 일차원 List<T>입니다. Array에는 0부터 시작하는 인덱스가 있어야 합니다.

arrayIndex
Int32

array에서 복사가 시작되는 0부터 시작하는 인덱스입니다.

count
Int32

복사할 요소의 수입니다.

예외

ArgumentNullException

array이(가) null인 경우

ArgumentOutOfRangeException

index 가 0보다 작습니다.

또는

arrayIndex 가 0보다 작습니다.

또는

count 가 0보다 작습니다.

ArgumentException

index가 소스 List<T>의 Count보다 크거나 같습니다.

또는

소스 List<T>의 index부터 끝까지에 포함된 요소 수가 대상 array의 arrayIndex부터 끝까지의 사용 가능한 공간보다 큽니다.

설명

이 메서드는 를 사용하여 Array.Copy 요소를 복사합니다.

요소는 열거자가 를 반복List<T>하는 순서와 동일한 순서로 에 복사 Array 됩니다.

이 메서드는 O(n) 작업이며 여기서 n 은 입니다 count.

적용 대상

CopyTo(T[])

Source:
List.cs
Source:
List.cs
Source:
List.cs

대상 배열의 처음부터 시작하여 전체 List<T>을 호환되는 1차원 배열에 복사합니다.

public:
 void CopyTo(cli::array <T> ^ array);
public void CopyTo (T[] array);
member this.CopyTo : 'T[] -> unit
Public Sub CopyTo (array As T())

매개 변수

array
T[]

Array에서 복사한 요소의 대상인 일차원 List<T>입니다. Array에는 0부터 시작하는 인덱스가 있어야 합니다.

예외

ArgumentNullException

array이(가) null인 경우

ArgumentException

소스 List<T> 요소 수가 대상 array를 포함할 수 있는 요소 수보다 큽니다.

설명

이 메서드는 를 사용하여 Array.Copy 요소를 복사합니다.

요소는 열거자가 를 반복List<T>하는 순서와 동일한 순서로 에 복사 Array 됩니다.

이 메서드는 O(n) 작업이며 여기서 n 은 입니다 Count.

적용 대상