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

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

Herança

Object

ArrayList

Derivado

System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection

Atributos

SerializableAttribute ComVisibleAttribute

Implementações

ICollection IEnumerable IList ICloneable

Exemplos

O exemplo a seguir mostra como criar e inicializar um ArrayList e como exibir seus valores.

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   !

*/

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   !

Comentários

Não ArrayList há garantia de que o seja classificado. Você deve classificar o ArrayList chamando seu Sort método antes de executar operações (como BinarySearch) que exigem que o ArrayList seja classificado. Para manter uma coleção que é classificada automaticamente à medida que novos elementos são adicionados, você pode usar a SortedSet<T> classe .

A capacidade de um ArrayList é o número de elementos que o ArrayList pode conter. À medida que os elementos são adicionados a um ArrayList, a capacidade é aumentada automaticamente conforme necessário por meio da realocação. A capacidade pode ser reduzida chamando TrimToSize ou definindo a Capacity propriedade explicitamente.

.NET Framework apenas: para objetos muito grandesArrayList, você pode aumentar a capacidade máxima para 2 bilhões de elementos em um sistema de 64 bits definindo o enabled atributo do elemento de <gcAllowVeryLargeObjects> configuração como true no ambiente de tempo de execução.

Os elementos nesta 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 um valor válido. Ele também permite elementos duplicados.

Não há suporte para o uso de matrizes multidimensionais como elementos em uma ArrayList coleção.

Construtores

Propriedades

Métodos

Métodos de Extensão

Aplica-se a

Acesso thread-safe

Os membros estáticos públicos (Shared no Visual Basic) desse são thread-safe. Não há garantia de que qualquer membro de instância seja seguro para threads.

Um ArrayList pode dar suporte a vários leitores simultaneamente, desde que a coleção não seja modificada. Para garantir a segurança de thread do ArrayList, todas as operações devem ser feitas por meio do wrapper retornado pelo Synchronized(IList) método .

A enumeração por meio de uma coleção não é um procedimento thread-safe intrínseco. Mesmo quando uma coleção está sincronizada, outros threads ainda podem modificar a coleção, o que faz o enumerador lançar uma exceção. Para garantir thread-safe durante a enumeração, é possível bloquear a coleção durante toda a enumeração ou verificar as exceções resultantes das alterações feitas por outros threads.

Confira também

• IList
• List<T>
• Executando operações de cadeia de caracteres Culture-Insensitive em coleções