Lire en anglais

Partager via


ArrayList.CopyTo Méthode

Définition

Copie ArrayList ou une partie de celui-ci dans un tableau unidimensionnel.

Surcharges

CopyTo(Array)

Copie l’ensemble de ArrayList dans un Array compatible unidimensionnel en commençant au début du tableau cible.

CopyTo(Array, Int32)

Copie l'ensemble de l'objet ArrayList vers un objet Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible.

CopyTo(Int32, Array, Int32, Int32)

Copie une plage d’éléments de ArrayList vers un Array unidimensionnel compatible, en commençant à l’index spécifié du tableau cible.

CopyTo(Array)

Source:
ArrayList.cs
Source:
ArrayList.cs
Source:
ArrayList.cs

Copie l’ensemble de ArrayList dans un Array compatible unidimensionnel en commençant au début du tableau cible.

C#
public virtual void CopyTo (Array array);

Paramètres

array
Array

Array unidimensionnel qui constitue la destination des éléments copiés à partir de ArrayList. Array doit avoir une indexation de base zéro.

Exceptions

array a la valeur null.

array est multidimensionnel.

- ou -

Le nombre d’éléments du ArrayList source est supérieur au nombre d’éléments que la destination array peut contenir.

Le type du ArrayList source ne peut pas être converti automatiquement en type du array de destination.

Exemples

L’exemple de code suivant montre comment copier un dans ArrayList un System.Array.

C#
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
*/

Remarques

Le tableau spécifié doit être d’un type compatible.

Cette méthode utilise Array.Copy pour copier les éléments.

Les éléments sont copiés dans le Array dans le même ordre que celui dans lequel l’énumérateur effectue une itération dans le ArrayList.

Cette méthode est une O(n) opération, où n est Count.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

CopyTo(Array, Int32)

Source:
ArrayList.cs
Source:
ArrayList.cs
Source:
ArrayList.cs

Copie l'ensemble de l'objet ArrayList vers un objet Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible.

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

Paramètres

array
Array

Array unidimensionnel qui constitue la destination des éléments copiés à partir de ArrayList. Array doit avoir une indexation de base zéro.

arrayIndex
Int32

Index de base zéro dans l'array à partir duquel la copie commence.

Implémente

Exceptions

array a la valeur null.

arrayIndex est inférieur à zéro.

array est multidimensionnel.

- ou -

Le nombre d’éléments dans le ArrayList source est supérieur à la quantité d’espace disponible entre arrayIndex et la fin du array de destination.

Le type du ArrayList source ne peut pas être converti automatiquement en type du array de destination.

Exemples

L’exemple de code suivant montre comment copier un dans ArrayList un System.Array.

C#
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

*/

Remarques

Le tableau spécifié doit être d’un type compatible.

Cette méthode utilise Array.Copy pour copier les éléments.

Les éléments sont copiés dans le Array dans le même ordre que celui dans lequel l’énumérateur effectue une itération dans le ArrayList.

Cette méthode est une O(n) opération, où n est Count.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

CopyTo(Int32, Array, Int32, Int32)

Source:
ArrayList.cs
Source:
ArrayList.cs
Source:
ArrayList.cs

Copie une plage d’éléments de ArrayList vers un Array unidimensionnel compatible, en commençant à l’index spécifié du tableau cible.

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

Paramètres

index
Int32

Index de base zéro dans le ArrayList source au niveau duquel la copie commence.

array
Array

Array unidimensionnel qui constitue la destination des éléments copiés à partir de ArrayList. Array doit avoir une indexation de base zéro.

arrayIndex
Int32

Index de base zéro dans l'array à partir duquel la copie commence.

count
Int32

Nombre d’éléments à copier.

Exceptions

array a la valeur null.

index est inférieur à zéro.

- ou -

arrayIndex est inférieur à zéro.

- ou -

count est inférieur à zéro.

array est multidimensionnel.

- ou -

index est égal ou supérieur au Count de la source ArrayList.

- ou -

Le nombre d’éléments entre index et la fin de la source ArrayList est supérieur à l’espace disponible entre arrayIndex et la fin de la destination array.

Le type du ArrayList source ne peut pas être converti automatiquement en type du array de destination.

Exemples

L’exemple de code suivant montre comment copier un dans ArrayList un System.Array.

C#
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

*/

Remarques

Le tableau spécifié doit être d’un type compatible.

Cette méthode utilise Array.Copy pour copier les éléments.

Les éléments sont copiés dans le Array dans le même ordre que celui dans lequel l’énumérateur effectue une itération dans le ArrayList.

Cette méthode est une O(n) opération, où n est count.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0