List<T>.CopyTo Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Kopiuje List<T> część lub do tablicy.
Przeciążenia
| Nazwa | Opis |
|---|---|
| CopyTo(T[], Int32) |
Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej. |
| CopyTo(Int32, T[], Int32, Int32) |
Kopiuje szereg elementów z List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej. |
| CopyTo(T[]) |
Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od początku tablicy docelowej. |
Przykłady
W poniższym przykładzie przedstawiono wszystkie trzy przeciążenia CopyTo metody. Ciągi List<T> są tworzone i wypełniane 5 ciągami. Tworzona jest pusta tablica ciągów zawierająca 15 elementów, a CopyTo(T[]) przeciążenie metody służy do kopiowania wszystkich elementów listy do tablicy rozpoczynającej się od pierwszego elementu tablicy. Przeciążenie CopyTo(T[], Int32) metody służy do kopiowania wszystkich elementów listy do tablicy rozpoczynającej się od indeksu tablicy 6 (pozostawiając indeks 5 pusty). CopyTo(Int32, T[], Int32, Int32) Na koniec przeciążenie metody służy do kopiowania 3 elementów z listy, począwszy od indeksu 2, do tablicy rozpoczynającej się od indeksu tablicy 12 (pozostawiając indeks 11 pusty). Następnie zostanie wyświetlona zawartość tablicy.
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)
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej.
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)
Parametry
- array
- T[]
Jednowymiarowy Array obiekt docelowy elementów skopiowanych z List<T>elementu . Element Array musi mieć indeksowanie oparte na zerach.
- arrayIndex
- Int32
Indeks oparty na zera, w array którym rozpoczyna się kopiowanie.
Implementuje
Wyjątki
Parametr array ma wartość null.
arrayIndex wartość jest mniejsza niż 0.
Liczba elementów w źródle List<T> jest większa niż dostępna przestrzeń z arrayIndex do końca miejsca docelowego array.
Uwagi
Ta metoda służy Array.Copy do kopiowania elementów.
Elementy są kopiowane do Array elementu w tej samej kolejności, w której moduł wyliczający iteruje za pośrednictwem elementu List<T>.
Ta metoda jest operacją O(n), gdzie n to Count.
Dotyczy
CopyTo(Int32, T[], Int32, Int32)
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
Kopiuje szereg elementów z List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej.
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)
Parametry
- array
- T[]
Jednowymiarowy Array obiekt docelowy elementów skopiowanych z List<T>elementu . Element Array musi mieć indeksowanie oparte na zerach.
- arrayIndex
- Int32
Indeks oparty na zera, w array którym rozpoczyna się kopiowanie.
- count
- Int32
Liczba elementów do skopiowania.
Wyjątki
Parametr array ma wartość null.
index wartość jest mniejsza niż 0.
— lub —
arrayIndex wartość jest mniejsza niż 0.
— lub —
count wartość jest mniejsza niż 0.
index jest równe lub większe niż Count źródło List<T>.
— lub —
Liczba elementów od index do końca źródła List<T> jest większa niż dostępna przestrzeń z arrayIndex do końca miejsca docelowego array.
Uwagi
Ta metoda służy Array.Copy do kopiowania elementów.
Elementy są kopiowane do Array elementu w tej samej kolejności, w której moduł wyliczający iteruje za pośrednictwem elementu List<T>.
Ta metoda jest operacją O(n), gdzie n to count.
Dotyczy
CopyTo(T[])
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
- Źródło:
- List.cs
Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od początku tablicy docelowej.
public:
void CopyTo(cli::array <T> ^ array);
public void CopyTo(T[] array);
member this.CopyTo : 'T[] -> unit
Public Sub CopyTo (array As T())
Parametry
- array
- T[]
Jednowymiarowy Array obiekt docelowy elementów skopiowanych z List<T>elementu . Element Array musi mieć indeksowanie oparte na zerach.
Wyjątki
Parametr array ma wartość null.
Liczba elementów w źródle List<T> jest większa niż liczba elementów, które może zawierać miejsce docelowe array .
Uwagi
Ta metoda służy Array.Copy do kopiowania elementów.
Elementy są kopiowane do Array elementu w tej samej kolejności, w której moduł wyliczający iteruje za pośrednictwem elementu List<T>.
Ta metoda jest operacją O(n), gdzie n to Count.