ArrayList Classe

Définition

public ref class ArrayList : System::Collections::IList

public ref class ArrayList : ICloneable, System::Collections::IList

public class ArrayList : System.Collections.IList

public class ArrayList : ICloneable, System.Collections.IList

[System.Serializable]
public class ArrayList : ICloneable, System.Collections.IList

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArrayList : ICloneable, System.Collections.IList

type ArrayList = class
    interface IEnumerable
    interface IList
    interface ICollection

type ArrayList = class
    interface ICollection
    interface IEnumerable
    interface IList
    interface ICloneable

type ArrayList = class
    interface IEnumerable
    interface IList
    interface ICollection
    interface ICloneable

[<System.Serializable>]
type ArrayList = class
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArrayList = class
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class ArrayList
Implements IList

Public Class ArrayList
Implements ICloneable, IList

Héritage

Object

ArrayList

Dérivé

System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection

Attributs

SerializableAttribute ComVisibleAttribute

Implémente

ICollection IEnumerable IList ICloneable

Exemples

L’exemple 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   !

*/

Imports System.Collections

Public Class SamplesArrayList    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new ArrayList.
        Dim myAL As 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)
    End Sub

    Public Shared Sub PrintValues(myList As IEnumerable)
        Dim obj As [Object]
        For Each obj In  myList
            Console.Write("   {0}", obj)
        Next obj
        Console.WriteLine()
    End Sub

End Class


' This code produces output similar to the following:
' 
' myAL
'     Count:    3
'     Capacity: 4
'     Values:   Hello   World   !

Remarques

Il n’est pas garanti que la classe ArrayList soit triée. Vous devez trier la ArrayList méthode en appelant sa Sort méthode avant d’effectuer des opérations (par exemple BinarySearch) qui nécessitent le ArrayList tri. Pour conserver une collection qui est automatiquement triée en tant que nouveaux éléments sont ajoutés, vous pouvez utiliser la SortedSet<T> classe.

La capacité d’un ArrayList élément correspond au nombre d’éléments ArrayList pouvant être suspendus. À mesure que les éléments sont ajoutés à un ArrayList, la capacité est automatiquement augmentée en fonction des besoins grâce à la réaffectation. La capacité peut être réduite en appelant TrimToSize ou en définissant explicitement la Capacity propriété.

.NET Framework uniquement : Pour les objets très volumineux ArrayList , vous pouvez augmenter la capacité maximale à 2 milliards d’éléments sur un système 64 bits en définissant l’attribut enabled de l’élément <gcAllowVeryLargeObjects>true de configuration sur l’environnement d’exécution.

Les éléments de cette collection sont accessibles à l’aide d’un index entier. Les index de cette collection sont basés sur zéro.

La ArrayList collection accepte null comme valeur valide. Il autorise également les éléments dupliqués.

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

Cohérence de thread

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'y a aucune garantie que les membres d’instance soient thread-safe.

Un ArrayList peut prendre en charge plusieurs lecteurs simultanément, tant que la collection n’est pas modifiée. Pour garantir la sécurité du thread, ArrayListtoutes les opérations doivent être effectuées via le wrapper retourné par la Synchronized(IList) méthode.

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

Voir aussi

• IList
• List<T>
• Exécution d’opérations de chaîne Culture-Insensitive dans les collections