ArrayList.CopyTo Metoda

Definicja

Przestrzeń nazw:: System.Collections

Zestawy:: mscorlib.dll, System.Collections.NonGeneric.dll

Zestawy:: netstandard.dll, System.Runtime.dll

Zestaw:: System.Collections.NonGeneric.dll

Zestaw:: System.Runtime.Extensions.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

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 ArrayList część lub do tablicy jednowymiarowej.

Przeciążenia

Nazwa	Opis
CopyTo(Array)	Kopiuje całą ArrayList do zgodnej jednowymiarowej Array, począwszy od początku tablicy docelowej.
CopyTo(Array, Int32)	Kopiuje całość ArrayList do zgodnego jednowymiarowego Array, zaczynając od określonego indeksu tablicy docelowej.
CopyTo(Int32, Array, Int32, Int32)	Kopiuje szereg elementów z ArrayList do zgodnego jednowymiarowego Array, począwszy od określonego indeksu tablicy docelowej.

CopyTo(Array)

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Kopiuje całą ArrayList do zgodnej jednowymiarowej Array, począwszy od początku tablicy docelowej.

public:
 virtual void CopyTo(Array ^ array);

public virtual void CopyTo(Array array);

abstract member CopyTo : Array -> unit
override this.CopyTo : Array -> unit

Public Overridable Sub CopyTo (array As Array)

Parametry

array: Array

Jednowymiarowy Array obiekt docelowy elementów skopiowanych z ArrayListelementu . Element Array musi mieć indeksowanie oparte na zerach.

Wyjątki

ArgumentNullException

Parametr array ma wartość null.

ArgumentException

array jest wielowymiarowa.

— lub —

Liczba elementów w źródle ArrayList jest większa niż liczba elementów, które może zawierać miejsce docelowe array .

InvalidCastException

Typ źródła ArrayList nie może być rzutowy automatycznie na typ miejsca docelowego array.

Przykłady

Poniższy przykład kodu pokazuje, jak skopiować element ArrayList do jednowymiarowego System.Arrayelementu .

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

   public static void Main()  {

      // Creates and initializes the source ArrayList.
      ArrayList mySourceList = new ArrayList();
      mySourceList.Add( "three" );
      mySourceList.Add( "napping" );
      mySourceList.Add( "cats" );
      mySourceList.Add( "in" );
      mySourceList.Add( "the" );
      mySourceList.Add( "barn" );

      // Creates and initializes the one-dimensional target Array.
      String[] myTargetArray = new String[15];
      myTargetArray[0] = "The";
      myTargetArray[1] = "quick";
      myTargetArray[2] = "brown";
      myTargetArray[3] = "fox";
      myTargetArray[4] = "jumps";
      myTargetArray[5] = "over";
      myTargetArray[6] = "the";
      myTargetArray[7] = "lazy";
      myTargetArray[8] = "dog";

      // Displays the values of the target Array.
      Console.WriteLine( "The target Array contains the following (before and after copying):" );
      PrintValues( myTargetArray, ' ' );

      // Copies the second element from the source ArrayList to the target Array starting at index 7.
      mySourceList.CopyTo( 1, myTargetArray, 7, 1 );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );

      // Copies the entire source ArrayList to the target Array starting at index 6.
      mySourceList.CopyTo( myTargetArray, 6 );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );

      // Copies the entire source ArrayList to the target Array starting at index 0.
      mySourceList.CopyTo( myTargetArray );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );
   }

   public static void PrintValues( String[] myArr, char mySeparator )  {
      for ( int i = 0; i < myArr.Length; i++ )
         Console.Write( "{0}{1}", mySeparator, myArr[i] );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

The target Array contains the following (before and after copying):
 The quick brown fox jumps over the lazy dog
 The quick brown fox jumps over the napping dog
 The quick brown fox jumps over three napping cats in the barn
 three napping cats in the barn three napping cats in the barn
*/

Imports System.Collections

Public Class SamplesArrayList    
    
    Public Shared Sub Main()
        
        ' Creates and initializes the source ArrayList.
        Dim mySourceList As New ArrayList()
        mySourceList.Add("three")
        mySourceList.Add("napping")
        mySourceList.Add("cats")
        mySourceList.Add("in")
        mySourceList.Add("the")
        mySourceList.Add("barn")
        
        ' Creates and initializes the one-dimensional target Array.
        Dim myTargetArray(14) As String
        myTargetArray(0) = "The"
        myTargetArray(1) = "quick"
        myTargetArray(2) = "brown"
        myTargetArray(3) = "fox"
        myTargetArray(4) = "jumps"
        myTargetArray(5) = "over"
        myTargetArray(6) = "the"
        myTargetArray(7) = "lazy"
        myTargetArray(8) = "dog"
        
        ' Displays the values of the target Array.
        Console.WriteLine("The target Array contains the following " _
           + "(before and after copying):")
        PrintValues(myTargetArray, " "c)
        
        ' Copies the second element from the source ArrayList to the target
        ' Array starting at index 7.
        mySourceList.CopyTo(1, myTargetArray, 7, 1)
        
        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)
        
        ' Copies the entire source ArrayList to the target Array starting
        ' at index 6.
        mySourceList.CopyTo(myTargetArray, 6)
        
        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)
        
        ' Copies the entire source ArrayList to the target Array starting
        ' at index 0.
        mySourceList.CopyTo(myTargetArray)
        
        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)
    End Sub    
    
    Public Shared Sub PrintValues(myArr() As String, mySeparator As Char)
        Dim i As Integer
        For i = 0 To myArr.Length - 1
            Console.Write("{0}{1}", mySeparator, myArr(i))
        Next i
        Console.WriteLine()
    End Sub
    
End Class


' This code produces the following output.
' 
' The target Array contains the following (before and after copying):
'  The quick brown fox jumps over the lazy dog      
'  The quick brown fox jumps over the napping dog      
'  The quick brown fox jumps over three napping cats in the barn   
'  three napping cats in the barn three napping cats in the barn

Uwagi

Określona tablica musi być zgodnym typem.

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 ArrayList.

Ta metoda jest operacją O(n) , gdzie n to Count.

Dotyczy

CopyTo(Array, Int32)

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Kopiuje całość ArrayList do zgodnego jednowymiarowego Array, zaczynając od określonego indeksu tablicy docelowej.

public:
 virtual void CopyTo(Array ^ array, int arrayIndex);

public virtual void CopyTo(Array array, int arrayIndex);

abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit

Public Overridable Sub CopyTo (array As Array, arrayIndex As Integer)

Parametry

array: Array

Jednowymiarowy Array obiekt docelowy elementów skopiowanych z ArrayListelementu . Element Array musi mieć indeksowanie oparte na zerach.

arrayIndex: Int32

Indeks oparty na zera, w array którym rozpoczyna się kopiowanie.

Implementuje

CopyTo(Array, Int32)

Wyjątki

ArgumentNullException

Parametr array ma wartość null.

ArgumentOutOfRangeException

Parametr arrayIndex ma wartość niższą niż zero.

ArgumentException

array jest wielowymiarowa.

— lub —

Liczba elementów w źródle ArrayList jest większa niż dostępna przestrzeń z arrayIndex do końca miejsca docelowego array.

InvalidCastException

Typ źródła ArrayList nie może być rzutowy automatycznie na typ miejsca docelowego array.

Przykłady

Poniższy przykład kodu pokazuje, jak skopiować element ArrayList do jednowymiarowego System.Arrayelementu .

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

   public static void Main()  {

      // Creates and initializes the source ArrayList.
      ArrayList mySourceList = new ArrayList();
      mySourceList.Add( "three" );
      mySourceList.Add( "napping" );
      mySourceList.Add( "cats" );
      mySourceList.Add( "in" );
      mySourceList.Add( "the" );
      mySourceList.Add( "barn" );

      // Creates and initializes the one-dimensional target Array.
      String[] myTargetArray = new String[15];
      myTargetArray[0] = "The";
      myTargetArray[1] = "quick";
      myTargetArray[2] = "brown";
      myTargetArray[3] = "fox";
      myTargetArray[4] = "jumps";
      myTargetArray[5] = "over";
      myTargetArray[6] = "the";
      myTargetArray[7] = "lazy";
      myTargetArray[8] = "dog";

      // Displays the values of the target Array.
      Console.WriteLine( "The target Array contains the following (before and after copying):" );
      PrintValues( myTargetArray, ' ' );

      // Copies the second element from the source ArrayList to the target Array, starting at index 7.
      mySourceList.CopyTo( 1, myTargetArray, 7, 1 );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );

      // Copies the entire source ArrayList to the target Array, starting at index 6.
      mySourceList.CopyTo( myTargetArray, 6 );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );

      // Copies the entire source ArrayList to the target Array, starting at index 0.
      mySourceList.CopyTo( myTargetArray );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );
   }

   public static void PrintValues( String[] myArr, char mySeparator )  {
      for ( int i = 0; i < myArr.Length; i++ )
         Console.Write( "{0}{1}", mySeparator, myArr[i] );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

The target Array contains the following (before and after copying):
 The quick brown fox jumps over the lazy dog
 The quick brown fox jumps over the napping dog
 The quick brown fox jumps over three napping cats in the barn
 three napping cats in the barn three napping cats in the barn

*/

Imports System.Collections

Public Class SamplesArrayList

    Public Shared Sub Main()

        ' Creates and initializes the source ArrayList.
        Dim mySourceList As New ArrayList()
        mySourceList.Add("three")
        mySourceList.Add("napping")
        mySourceList.Add("cats")
        mySourceList.Add("in")
        mySourceList.Add("the")
        mySourceList.Add("barn")

        ' Creates and initializes the one-dimensional target Array.
        Dim myTargetArray(14) As String
        myTargetArray(0) = "The"
        myTargetArray(1) = "quick"
        myTargetArray(2) = "brown"
        myTargetArray(3) = "fox"
        myTargetArray(4) = "jumps"
        myTargetArray(5) = "over"
        myTargetArray(6) = "the"
        myTargetArray(7) = "lazy"
        myTargetArray(8) = "dog"

        ' Displays the values of the target Array.
        Console.WriteLine("The target Array contains the following (before and after copying):")
        PrintValues(myTargetArray, " "c)

        ' Copies the second element from the source ArrayList to the target Array, starting at index 7.
        mySourceList.CopyTo(1, myTargetArray, 7, 1)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

        ' Copies the entire source ArrayList to the target Array, starting at index 6.
        mySourceList.CopyTo(myTargetArray, 6)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

        ' Copies the entire source ArrayList to the target Array, starting at index 0.
        mySourceList.CopyTo(myTargetArray)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

    End Sub

    Public Shared Sub PrintValues(myArr() As String, mySeparator As Char)
        Dim i As Integer
        For i = 0 To myArr.Length - 1
            Console.Write("{0}{1}", mySeparator, myArr(i))
        Next i
        Console.WriteLine()
    End Sub

End Class


' This code produces the following output.
' 
' The target Array contains the following (before and after copying):
'  The quick brown fox jumps over the lazy dog
'  The quick brown fox jumps over the napping dog
'  The quick brown fox jumps over three napping cats in the barn
'  three napping cats in the barn three napping cats in the barn

Uwagi

Określona tablica musi być zgodnym typem.

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 ArrayList.

Ta metoda jest operacją O(n) , gdzie n to Count.

Dotyczy

CopyTo(Int32, Array, Int32, Int32)

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Źródło:: ArrayList.cs

Kopiuje szereg elementów z ArrayList do zgodnego jednowymiarowego Array, począwszy od określonego indeksu tablicy docelowej.

public:
 virtual void CopyTo(int index, Array ^ array, int arrayIndex, int count);

public virtual void CopyTo(int index, Array array, int arrayIndex, int count);

abstract member CopyTo : int * Array * int * int -> unit
override this.CopyTo : int * Array * int * int -> unit

Public Overridable Sub CopyTo (index As Integer, array As Array, arrayIndex As Integer, count As Integer)

Parametry

index: Int32

Indeks oparty na zera w źródle ArrayList , w którym rozpoczyna się kopiowanie.

array: Array

Jednowymiarowy Array obiekt docelowy elementów skopiowanych z ArrayListelementu . 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

ArgumentNullException

Parametr array ma wartość null.

ArgumentOutOfRangeException

Parametr index ma wartość niższą niż zero.

— lub —

Parametr arrayIndex ma wartość niższą niż zero.

— lub —

Parametr count ma wartość niższą niż zero.

ArgumentException

array jest wielowymiarowa.

— lub —

index jest równe lub większe niż Count źródło ArrayList.

— lub —

Liczba elementów od index do końca źródła ArrayList jest większa niż dostępna przestrzeń z arrayIndex do końca miejsca docelowego array.

InvalidCastException

Typ źródła ArrayList nie może być rzutowy automatycznie na typ miejsca docelowego array.

Przykłady

Poniższy przykład kodu pokazuje, jak skopiować element ArrayList do jednowymiarowego System.Arrayelementu .

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

   public static void Main()  {

      // Creates and initializes the source ArrayList.
      ArrayList mySourceList = new ArrayList();
      mySourceList.Add( "three" );
      mySourceList.Add( "napping" );
      mySourceList.Add( "cats" );
      mySourceList.Add( "in" );
      mySourceList.Add( "the" );
      mySourceList.Add( "barn" );

      // Creates and initializes the one-dimensional target Array.
      String[] myTargetArray = new String[15];
      myTargetArray[0] = "The";
      myTargetArray[1] = "quick";
      myTargetArray[2] = "brown";
      myTargetArray[3] = "fox";
      myTargetArray[4] = "jumps";
      myTargetArray[5] = "over";
      myTargetArray[6] = "the";
      myTargetArray[7] = "lazy";
      myTargetArray[8] = "dog";

      // Displays the values of the target Array.
      Console.WriteLine( "The target Array contains the following (before and after copying):" );
      PrintValues( myTargetArray, ' ' );

      // Copies the second element from the source ArrayList to the target Array, starting at index 7.
      mySourceList.CopyTo( 1, myTargetArray, 7, 1 );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );

      // Copies the entire source ArrayList to the target Array, starting at index 6.
      mySourceList.CopyTo( myTargetArray, 6 );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );

      // Copies the entire source ArrayList to the target Array, starting at index 0.
      mySourceList.CopyTo( myTargetArray );

      // Displays the values of the target Array.
      PrintValues( myTargetArray, ' ' );
   }

   public static void PrintValues( String[] myArr, char mySeparator )  {
      for ( int i = 0; i < myArr.Length; i++ )
         Console.Write( "{0}{1}", mySeparator, myArr[i] );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

The target Array contains the following (before and after copying):
 The quick brown fox jumps over the lazy dog
 The quick brown fox jumps over the napping dog
 The quick brown fox jumps over three napping cats in the barn
 three napping cats in the barn three napping cats in the barn

*/

Imports System.Collections

Public Class SamplesArrayList

    Public Shared Sub Main()

        ' Creates and initializes the source ArrayList.
        Dim mySourceList As New ArrayList()
        mySourceList.Add("three")
        mySourceList.Add("napping")
        mySourceList.Add("cats")
        mySourceList.Add("in")
        mySourceList.Add("the")
        mySourceList.Add("barn")

        ' Creates and initializes the one-dimensional target Array.
        Dim myTargetArray(14) As String
        myTargetArray(0) = "The"
        myTargetArray(1) = "quick"
        myTargetArray(2) = "brown"
        myTargetArray(3) = "fox"
        myTargetArray(4) = "jumps"
        myTargetArray(5) = "over"
        myTargetArray(6) = "the"
        myTargetArray(7) = "lazy"
        myTargetArray(8) = "dog"

        ' Displays the values of the target Array.
        Console.WriteLine("The target Array contains the following (before and after copying):")
        PrintValues(myTargetArray, " "c)

        ' Copies the second element from the source ArrayList to the target Array, starting at index 7.
        mySourceList.CopyTo(1, myTargetArray, 7, 1)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

        ' Copies the entire source ArrayList to the target Array, starting at index 6.
        mySourceList.CopyTo(myTargetArray, 6)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

        ' Copies the entire source ArrayList to the target Array, starting at index 0.
        mySourceList.CopyTo(myTargetArray)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

    End Sub

    Public Shared Sub PrintValues(myArr() As String, mySeparator As Char)
        Dim i As Integer
        For i = 0 To myArr.Length - 1
            Console.Write("{0}{1}", mySeparator, myArr(i))
        Next i
        Console.WriteLine()
    End Sub

End Class


' This code produces the following output.
' 
' The target Array contains the following (before and after copying):
'  The quick brown fox jumps over the lazy dog
'  The quick brown fox jumps over the napping dog
'  The quick brown fox jumps over three napping cats in the barn
'  three napping cats in the barn three napping cats in the barn

Uwagi

Określona tablica musi być zgodnym typem.

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 ArrayList.

Ta metoda jest operacją O(n) , gdzie n to count.

Dotyczy

Opinia

Czy ta strona była pomocna?