Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

ArrayList, classe

Implémente l'interface IList à l'aide d'un tableau dont la taille est augmentée de manière dynamique.

Espace de noms :  System.Collections
Assembly :  mscorlib (dans mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArrayList : IList, ICollection, 
	IEnumerable, ICloneable

Le type ArrayList expose les membres suivants.

  NomDescription
Méthode publiquePris en charge par XNA FrameworkArrayList()Initialise une nouvelle instance de la classe ArrayList qui est vide et possède la capacité initiale par défaut.
Méthode publiquePris en charge par XNA FrameworkArrayList(ICollection)Initialise une nouvelle instance de la classe ArrayList qui contient des éléments copiés à partir de la collection spécifiée et qui possède la capacité initiale correspondant au nombre d'éléments copiés.
Méthode publiquePris en charge par XNA FrameworkArrayList(Int32)Initialise une nouvelle instance de la classe ArrayList qui est vide et a la capacité initiale spécifiée.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkCapacityObtient ou définit le nombre d'éléments que ArrayList peut contenir.
Propriété publiquePris en charge par XNA FrameworkCountObtient le nombre d'éléments réellement contenus dans ArrayList.
Propriété publiquePris en charge par XNA FrameworkIsFixedSizeObtient une valeur indiquant si ArrayList est de taille fixe.
Propriété publiquePris en charge par XNA FrameworkIsReadOnlyObtient une valeur indiquant si ArrayList est en lecture seule.
Propriété publiquePris en charge par XNA FrameworkIsSynchronizedObtient une valeur indiquant si l'accès à ArrayList est synchronisé (thread-safe).
Propriété publiquePris en charge par XNA FrameworkItemObtient ou définit l'élément situé à l'index spécifié.
Propriété publiquePris en charge par XNA FrameworkSyncRootObtient un objet qui peut être utilisé pour synchroniser l'accès au ArrayList.
Début

  NomDescription
Méthode publiqueMembre statiqueAdapterCrée un wrapper ArrayList pour un IList spécifique.
Méthode publiquePris en charge par XNA FrameworkAddAjoute un objet à la fin de ArrayList.
Méthode publiquePris en charge par XNA FrameworkAddRangeAjoute les éléments de ICollection à la fin de ArrayList.
Méthode publiqueBinarySearch(Object)Recherche un élément utilisant le comparateur par défaut dans le ArrayList entièrement trié et retourne l'index de base zéro de l'élément.
Méthode publiqueBinarySearch(Object, IComparer)Recherche un élément utilisant le comparateur spécifié dans le ArrayList entièrement trié et retourne l'index de base zéro de l'élément.
Méthode publiquePris en charge par XNA FrameworkBinarySearch(Int32, Int32, Object, IComparer)Recherche un élément utilisant le comparateur spécifié dans une plage d'éléments du ArrayList trié et retourne l'index de base zéro de l'élément.
Méthode publiquePris en charge par XNA FrameworkClearSupprime tous les éléments de ArrayList.
Méthode publiquePris en charge par XNA FrameworkCloneCrée une copie superficielle de ArrayList.
Méthode publiquePris en charge par XNA FrameworkContainsDétermine si un élément est dans ArrayList.
Méthode publiquePris en charge par XNA FrameworkCopyTo(Array)Copie l'ensemble du ArrayList dans un Array compatible unidimensionnel en commençant au début du tableau cible.
Méthode publiquePris en charge par XNA FrameworkCopyTo(Array, Int32)Copie l'ensemble du ArrayList vers un Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible.
Méthode publiquePris en charge par XNA FrameworkCopyTo(Int32, Array, Int32, Int32)Copie la plage d'éléments de ArrayList dans un Array compatible unidimensionnel en commençant à l'index spécifié du tableau cible.
Méthode publiquePris en charge par XNA FrameworkEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéePris en charge par XNA FrameworkFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueMembre statiqueFixedSize(ArrayList)Retourne un wrapper ArrayList de taille fixe.
Méthode publiqueMembre statiqueFixedSize(IList)Retourne un wrapper IList de taille fixe.
Méthode publiquePris en charge par XNA FrameworkGetEnumerator()Retourne un énumérateur pour l'intégralité de ArrayList.
Méthode publiqueGetEnumerator(Int32, Int32)Retourne un énumérateur pour une plage d'éléments de ArrayList.
Méthode publiquePris en charge par XNA FrameworkGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetRangeRetourne ArrayList qui représente un sous-ensemble des éléments dans le ArrayList source.
Méthode publiquePris en charge par XNA FrameworkGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkIndexOf(Object)Recherche le Object spécifié et retourne l'index de base zéro de la première occurrence dans l'ensemble du ArrayList.
Méthode publiqueIndexOf(Object, Int32)Recherche le Object spécifié et retourne l'index de base zéro de la première occurrence dans la plage d'éléments du ArrayList qui s'étend de l'index spécifié au dernier élément.
Méthode publiquePris en charge par XNA FrameworkIndexOf(Object, Int32, Int32)Recherche le Object spécifié et retourne l'index de base zéro de la première occurrence dans la plage d'éléments du ArrayList qui commence à l'index spécifié et qui contient le nombre d'éléments spécifié.
Méthode publiquePris en charge par XNA FrameworkInsertInsère un élément dans ArrayList à l'index spécifié.
Méthode publiquePris en charge par XNA FrameworkInsertRangeInsère les éléments d'une collection ArrayList à l'index spécifié.
Méthode publiqueLastIndexOf(Object)Recherche le Object spécifié et retourne l'index de base zéro de la dernière occurrence de l'ensemble du ArrayList.
Méthode publiqueLastIndexOf(Object, Int32)Recherche le Object spécifié et retourne l'index de base zéro de la dernière occurrence dans la plage d'éléments du ArrayList qui s'étend du premier élément à l'index spécifié.
Méthode publiqueLastIndexOf(Object, Int32, Int32)Recherche le Object spécifié et retourne l'index de base zéro de la dernière occurrence dans la plage d'éléments du ArrayList qui contient le nombre spécifié d'éléments et qui se termine à l'index spécifié.
Méthode protégéePris en charge par XNA FrameworkMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueMembre statiqueReadOnly(ArrayList)Retourne un wrapper ArrayList en lecture seule.
Méthode publiqueMembre statiqueReadOnly(IList)Retourne un wrapper IList en lecture seule.
Méthode publiquePris en charge par XNA FrameworkRemoveSupprime la première occurrence d'un objet spécifique de ArrayList.
Méthode publiquePris en charge par XNA FrameworkRemoveAtSupprime l'élément au niveau de l'index spécifié de ArrayList.
Méthode publiquePris en charge par XNA FrameworkRemoveRangeSupprime une plage d'éléments de ArrayList.
Méthode publiqueMembre statiqueRepeatRetourne ArrayList dont les éléments sont des copies de la valeur spécifiée.
Méthode publiquePris en charge par XNA FrameworkReverse()Inverse l'ordre des éléments dans l'intégralité de ArrayList.
Méthode publiquePris en charge par XNA FrameworkReverse(Int32, Int32)Inverse l'ordre des éléments dans la plage spécifiée.
Méthode publiqueSetRangeCopie les éléments d'une collection sur une plage d'éléments dans ArrayList.
Méthode publiquePris en charge par XNA FrameworkSort()Trie les éléments dans l'intégralité de ArrayList.
Méthode publiquePris en charge par XNA FrameworkSort(IComparer)Trie les éléments dans l'ensemble de ArrayList à l'aide du comparateur spécifié.
Méthode publiquePris en charge par XNA FrameworkSort(Int32, Int32, IComparer)Trie les éléments dans une plage d'éléments de ArrayList à l'aide du comparateur spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkSynchronized(ArrayList)Retourne un wrapper ArrayList qui est synchronisé (thread-safe).
Méthode publiqueMembre statiqueSynchronized(IList)Retourne un wrapper IList qui est synchronisé (thread-safe).
Méthode publiquePris en charge par XNA FrameworkToArray()Copie les éléments de ArrayList vers un nouveau tableau Object.
Méthode publiquePris en charge par XNA FrameworkToArray(Type)Copie les éléments de ArrayList vers un nouveau tableau du type d'élément spécifié.
Méthode publiquePris en charge par XNA FrameworkToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkTrimToSizeDéfinit la capacité au nombre réel d'éléments dans ArrayList.
Début

  NomDescription
Méthode d'extension publiqueAsParallelActive la parallélisation d'une requête. (Défini par ParallelEnumerable.)
Méthode d'extension publiqueAsQueryableConvertit un IEnumerable en IQueryable. (Défini par Queryable.)
Méthode d'extension publiquePris en charge par XNA FrameworkCast<TResult>Convertit les éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.)
Méthode d'extension publiquePris en charge par XNA FrameworkOfType<TResult>Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.)
Début

Le tri du ArrayList n'est pas garanti. Vous devez trier le ArrayList avant d'exécuter des opérations (telles que BinarySearch) qui exigent le tri du ArrayList.

La capacité de ArrayList correspond au nombre d'éléments que peut contenir ArrayList. Lorsque des éléments sont ajoutés à ArrayList, la capacité augmente automatiquement par réallocation. La capacité peut être diminuée en appelant TrimToSize ou en définissant explicitement la propriété Capacity.

Il est possible d'accéder aux éléments de cette collection en utilisant un index d'entiers. Les index de cette collection sont des index de base zéro.

La collection ArrayList accepte null comme valeur valide et autorise les éléments en double.

L'utilisation de tableaux multidimensionnels comme éléments dans une collection ArrayList n'est pas prise en charge.

L'exemple de code suivant montre comment créer et initialiser un ArrayList et comment afficher ses valeurs.


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

   public static void Main()  {

      // Creates and initializes a new ArrayList.
      ArrayList myAL = new ArrayList();
      myAL.Add("Hello");
      myAL.Add("World");
      myAL.Add("!");

      // Displays the properties and values of the ArrayList.
      Console.WriteLine( "myAL" );
      Console.WriteLine( "    Count:    {0}", myAL.Count );
      Console.WriteLine( "    Capacity: {0}", myAL.Capacity );
      Console.Write( "    Values:" );
      PrintValues( myAL );
   }

   public static void PrintValues( IEnumerable myList )  {
      foreach ( Object obj in myList )
         Console.Write( "   {0}", obj );
      Console.WriteLine();
   }

}


/* 
This code produces output similar to the following:

myAL
    Count:    3
    Capacity: 4
    Values:   Hello   World   !

*/


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

ArrayList peut prendre en charge plusieurs opérations de lecture simultanées, tant que la collection n'est pas modifiée. Afin de garantir la sécurité des threads de ArrayList, toutes les opérations doivent être effectuées par l'intermédiaire du wrapper retourné par la méthode Synchronized.

L'énumération d'une collection n'est intrinsèquement pas une procédure thread-safe. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours modifier la collection, ce qui entraîne la levée d'une exception par l'énumérateur. Pour garantir la sécurité des threads lors de l'énumération, vous pouvez verrouiller la collection pour toute la durée de l'énumération ou intercepter les exceptions résultant de modifications apportées par d'autres threads.

Afficher: