Implémente l'interface IList à l'aide d'un tableau dont la taille est augmentée de manière dynamique.
System.Collections.ArrayList
System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection
Espace de noms : System.Collections
Assembly : mscorlib (dans mscorlib.dll)
<SerializableAttribute> _ <ComVisibleAttribute(True)> _ Public Class ArrayList _ Implements IList, ICollection, IEnumerable, ICloneable
[SerializableAttribute] [ComVisibleAttribute(true)] public class ArrayList : IList, ICollection, IEnumerable, ICloneable
[SerializableAttribute] [ComVisibleAttribute(true)] public ref class ArrayList : IList, ICollection, IEnumerable, ICloneable
[<SerializableAttribute>] [<ComVisibleAttribute(true)>] type ArrayList = class interface IList interface ICollection interface IEnumerable interface ICloneable end
Le type ArrayList expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
ArrayList() | Initialise une nouvelle instance de la classe ArrayList qui est vide et possède la capacité initiale par défaut. |
|
ArrayList(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. |
|
ArrayList(Int32) | Initialise une nouvelle instance de la classe ArrayList qui est vide et a la capacité initiale spécifiée. |
| Nom | Description | |
|---|---|---|
|
Capacity | Obtient ou définit le nombre d'éléments que ArrayList peut contenir. |
|
Count | Obtient le nombre d'éléments réellement contenus dans ArrayList. |
|
IsFixedSize | Obtient une valeur indiquant si ArrayList est de taille fixe. |
|
IsReadOnly | Obtient une valeur indiquant si ArrayList est en lecture seule. |
|
IsSynchronized | Obtient une valeur indiquant si l'accès à ArrayList est synchronisé (thread-safe). |
|
Item | Obtient ou définit l'élément situé à l'index spécifié. |
|
SyncRoot | Obtient un objet qui peut être utilisé pour synchroniser l'accès au ArrayList. |
| Nom | Description | |
|---|---|---|
|
Adapter | Crée un wrapper ArrayList pour un IList spécifique. |
|
Add | Ajoute un objet à la fin de ArrayList. |
|
AddRange | Ajoute les éléments de ICollection à la fin de ArrayList. |
|
BinarySearch(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. |
|
BinarySearch(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. |
|
BinarySearch(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. |
|
Clear | Supprime tous les éléments de ArrayList. |
|
Clone | Crée une copie superficielle de ArrayList. |
|
Contains | Détermine si un élément est dans ArrayList. |
|
CopyTo(Array) | Copie l'ensemble du ArrayList dans un Array compatible unidimensionnel en commençant au début du tableau cible. |
|
CopyTo(Array, Int32) | Copie l'ensemble du ArrayList vers un Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible. |
|
CopyTo(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. |
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
FixedSize(ArrayList) | Retourne un wrapper ArrayList de taille fixe. |
|
FixedSize(IList) | Retourne un wrapper IList de taille fixe. |
|
GetEnumerator() | Retourne un énumérateur pour l'intégralité de ArrayList. |
|
GetEnumerator(Int32, Int32) | Retourne un énumérateur pour une plage d'éléments de ArrayList. |
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetRange | Retourne ArrayList qui représente un sous-ensemble des éléments dans le ArrayList source. |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
IndexOf(Object) | Recherche le Object spécifié et retourne l'index de base zéro de la première occurrence dans l'ensemble du ArrayList. |
|
IndexOf(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. |
|
IndexOf(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é. |
|
Insert | Insère un élément dans ArrayList à l'index spécifié. |
|
InsertRange | Insère les éléments d'une collection ArrayList à l'index spécifié. |
|
LastIndexOf(Object) | Recherche le Object spécifié et retourne l'index de base zéro de la dernière occurrence de l'ensemble du ArrayList. |
|
LastIndexOf(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é. |
|
LastIndexOf(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é. |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
ReadOnly(ArrayList) | Retourne un wrapper ArrayList en lecture seule. |
|
ReadOnly(IList) | Retourne un wrapper IList en lecture seule. |
|
Remove | Supprime la première occurrence d'un objet spécifique de ArrayList. |
|
RemoveAt | Supprime l'élément au niveau de l'index spécifié de ArrayList. |
|
RemoveRange | Supprime une plage d'éléments de ArrayList. |
|
Repeat | Retourne ArrayList dont les éléments sont des copies de la valeur spécifiée. |
|
Reverse() | Inverse l'ordre des éléments dans l'intégralité de ArrayList. |
|
Reverse(Int32, Int32) | Inverse l'ordre des éléments dans la plage spécifiée. |
|
SetRange | Copie les éléments d'une collection sur une plage d'éléments dans ArrayList. |
|
Sort() | Trie les éléments dans l'intégralité de ArrayList. |
|
Sort(IComparer) | Trie les éléments dans l'ensemble de ArrayList à l'aide du comparateur spécifié. |
|
Sort(Int32, Int32, IComparer) | Trie les éléments dans une plage d'éléments de ArrayList à l'aide du comparateur spécifié. |
|
Synchronized(ArrayList) | Retourne un wrapper ArrayList qui est synchronisé (thread-safe). |
|
Synchronized(IList) | Retourne un wrapper IList qui est synchronisé (thread-safe). |
|
ToArray() | Copie les éléments de ArrayList vers un nouveau tableau Object. |
|
ToArray(Type) | Copie les éléments de ArrayList vers un nouveau tableau du type d'élément spécifié. |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
TrimToSize | Définit la capacité au nombre réel d'éléments dans ArrayList. |
| Nom | Description | |
|---|---|---|
|
AsParallel | Active la parallélisation d'une requête. (Défini par ParallelEnumerable.) |
|
AsQueryable | Convertit un IEnumerable en IQueryable. (Défini par Queryable.) |
|
Cast<TResult> | Convertit les éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.) |
|
OfType<TResult> | Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.) |
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.
Imports System Imports System.Collections Imports Microsoft.VisualBasic 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 'PrintValues End Class ' This code produces output similar to the following: ' ' myAL ' Count: 3 ' Capacity: 4 ' Values: Hello World !
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 ! */
using namespace System; using namespace System::Collections; void PrintValues( IEnumerable^ myList ); int main() { // Creates and initializes a new ArrayList. ArrayList^ myAL = gcnew 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 ); } void PrintValues( IEnumerable^ myList ) { IEnumerator^ myEnum = myList->GetEnumerator(); while ( myEnum->MoveNext() ) { Object^ obj = safe_cast<Object^>(myEnum->Current); 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 SP1Windows 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.