ArrayList Classe

Definição

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

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

public class ArrayList : 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

public class ArrayList : ICloneable, System.Collections.IList

type ArrayList = class
    interface IEnumerable
    interface IList
    interface ICollection

[<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

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

Public Class ArrayList
Implements IList

Public Class ArrayList
Implements ICloneable, IList

Herança

Object

ArrayList

Derivado

System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection

Atributos

SerializableAttribute ComVisibleAttribute

Implementações

ICollection IEnumerable IList ICloneable

Exemplos

O exemplo seguinte mostra como criar e inicializar um ArrayList e como mostrar os seus valores.

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   !

Observações

Não se garante que ArrayList seja ordenado. Deve ordenar o ArrayList chamando o seu Sort método antes de realizar operações (como BinarySearch) que exijam que o ArrayList a ordenar. Para manter uma coleção que é automaticamente ordenada à medida que novos elementos são adicionados, pode usar a SortedSet<T> classe.

A capacidade de um ArrayList é o número de elementos que ArrayList podem dever. À medida que elementos são adicionados a um ArrayList, a capacidade é automaticamente aumentada conforme necessário através da realocação. A capacidade pode ser diminuída chamando TrimToSize ou definindo explicitamente a Capacity propriedade.

.NET Framework apenas: Para objetos muito grandes ArrayList, pode aumentar a capacidade máxima para 2 mil milhões de elementos num sistema de 64 bits definindo o atributo enabled do elemento de configuração <gcAllowVeryLargeObjects> para true no ambiente de execução.

Os elementos desta coleção podem ser acessados usando um índice inteiro. Os índices nesta coleção são baseados em zero.

A ArrayList coleção aceita null como valor válido. Também permite elementos duplicados.

O uso de arrays multidimensionais como elementos numa ArrayList coleção não é suportado.

Segurança de Thread

Os membros estáticos públicos (Shared em Visual Basic) deste tipo são seguros para threads. Qualquer membro de instância não é garantido que seja seguro contra threads.

An ArrayList pode suportar múltiplos leitores em simultâneo, desde que a coleção não seja modificada. Para garantir a segurança da thread do ArrayList, todas as operações devem ser feitas através do invólucro devolvido pelo Synchronized(IList) método.

Enumerar através de uma coleção não é, intrinsecamente, um procedimento seguro para threads. Mesmo quando uma coleção está sincronizada, outros threads ainda podem modificar a coleção, o que faz com que o enumerador lance uma exceção. Para garantir a segurança dos threads durante a enumeração, pode bloquear a coleção durante toda a enumeração ou apanhar as exceções resultantes de alterações feitas por outros threads.

Ver também

• IList
• List<T>
• Execução Culture-Insensitive Operações de Cordas em Coleções