Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe ArrayList

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Implementa a interface IList usando uma matriz cujo tamanho é aumentado dinamicamente conforme necessário.

Para procurar o código-fonte do .NET Framework para este tipo, consulte o Reference Source.

Namespace:   System.Collections
Assembly:  mscorlib (em mscorlib.dll)


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

NomeDescrição
System_CAPS_pubmethodArrayList()

Inicializa uma nova instância da classe ArrayList que está vazia e tem a capacidade inicial padrão.

System_CAPS_pubmethodArrayList(ICollection)

Inicializa uma nova instância da classe ArrayList, que contém os elementos copiados da coleção especificada e tem a mesma capacidade inicial que o número de elementos copiados.

System_CAPS_pubmethodArrayList(Int32)

Inicializa uma nova instância da classe ArrayList que está vazia e tem a capacidade inicial especificada.

NomeDescrição
System_CAPS_pubpropertyCapacity

Obtém ou define o número de elementos que o ArrayList pode conter.

System_CAPS_pubpropertyCount

Obtém o número de elementos realmente contidos no ArrayList.

System_CAPS_pubpropertyIsFixedSize

Obtém um valor que indica se o ArrayList tem um tamanho fixo.

System_CAPS_pubpropertyIsReadOnly

Obtém um valor que indica se o ArrayList é somente leitura.

System_CAPS_pubpropertyIsSynchronized

Obtém um valor que indica se o acesso à ArrayList é sincronizado (thread-safe).

System_CAPS_pubpropertyItem[Int32]

Obtém ou define o elemento no índice especificado.

System_CAPS_pubpropertySyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao ArrayList.

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticAdapter(IList)

Cria um wrapper ArrayList para um determinado IList.

System_CAPS_pubmethodAdd(Object)

Adiciona um objeto ao final do ArrayList.

System_CAPS_pubmethodAddRange(ICollection)

Adiciona os elementos de um ICollection ao final do ArrayList.

System_CAPS_pubmethodBinarySearch(Int32, Int32, Object, IComparer)

Pesquisa um intervalo de elementos no ArrayList classificado para encontrar um elemento que usa o comparador especificado e retorna o índice baseado em zero do elemento.

System_CAPS_pubmethodBinarySearch(Object)

Pesquisa todo o ArrayList classificado para um elemento usando o comparador padrão e retorna o índice baseado em zero do elemento.

System_CAPS_pubmethodBinarySearch(Object, IComparer)

Pesquisa um elemento em todo o ArrayList classificado usando o comparador especificado e retorna o índice baseado em zero do elemento.

System_CAPS_pubmethodClear()

Remove todos os elementos do ArrayList.

System_CAPS_pubmethodClone()

Cria uma cópia superficial do ArrayList.

System_CAPS_pubmethodContains(Object)

Determina se um elemento está no ArrayList.

System_CAPS_pubmethodCopyTo(Array)

Copia todo o ArrayList para um Array unidimensional compatível, a partir do início da matriz de destino.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia todo o ArrayList em um Array unidimensional compatível, começando no índice especificado da matriz de destino.

System_CAPS_pubmethodCopyTo(Int32, Array, Int32, Int32)

Copia um intervalo de elementos do ArrayList para um Array unidimensional compatível, começando pelo índice especificado da matriz de destino.

System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(ArrayList)

Retorna um wrapper ArrayList com um tamanho fixo.

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(IList)

Retorna um wrapper IList com um tamanho fixo.

System_CAPS_pubmethodGetEnumerator()

Retorna um enumerador para todo o ArrayList.

System_CAPS_pubmethodGetEnumerator(Int32, Int32)

Retorna um enumerador para um intervalo de elementos no ArrayList.

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetRange(Int32, Int32)

Retorna um ArrayList que representa um subconjunto dos elementos na origem ArrayList.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodIndexOf(Object)

Pesquisa o Object especificado e retorna o índice de base zero da primeira ocorrência dentro de todo o ArrayList.

System_CAPS_pubmethodIndexOf(Object, Int32)

Pesquisa o Object especificado e retorna o índice baseado em zero da primeira ocorrência dentro do intervalo de elementos no ArrayList que se estende do índice especificado ao último elemento.

System_CAPS_pubmethodIndexOf(Object, Int32, Int32)

Pesquisa o Object especificado e retorna o índice baseado em zero da primeira ocorrência dentro de um intervalo de elementos no ArrayList que começa no índice especificado e contém o número de elementos especificado.

System_CAPS_pubmethodInsert(Int32, Object)

Insere um elemento no ArrayList, no índice especificado.

System_CAPS_pubmethodInsertRange(Int32, ICollection)

Insere os elementos de uma coleção no ArrayList no índice especificado.

System_CAPS_pubmethodLastIndexOf(Object)

Pesquisa o Object especificado e retorna o índice de base zero da última ocorrência dentro de todo o ArrayList.

System_CAPS_pubmethodLastIndexOf(Object, Int32)

Procura especificado Object e retorna o índice baseado em zero da última ocorrência dentro do intervalo de elementos de ArrayList que se estende do primeiro elemento para o índice especificado.

System_CAPS_pubmethodLastIndexOf(Object, Int32, Int32)

Procura especificado Object e retorna o índice baseado em zero da última ocorrência dentro do intervalo de elementos de ArrayList que contém o número especificado de elementos e termina no índice especificado.

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(ArrayList)

Retorna um wrapper ArrayList de somente leitura.

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(IList)

Retorna um wrapper IList de somente leitura.

System_CAPS_pubmethodRemove(Object)

Remove a primeira ocorrência de um objeto específico do ArrayList.

System_CAPS_pubmethodRemoveAt(Int32)

Remove o elemento no índice especificado do ArrayList.

System_CAPS_pubmethodRemoveRange(Int32, Int32)

Remove um intervalo de elementos do ArrayList.

System_CAPS_pubmethodSystem_CAPS_staticRepeat(Object, Int32)

Retorna um ArrayList cujos elementos são cópias do valor especificado.

System_CAPS_pubmethodReverse()

Inverte a ordem dos elementos em todo o ArrayList.

System_CAPS_pubmethodReverse(Int32, Int32)

Inverte a ordem dos elementos no intervalo especificado.

System_CAPS_pubmethodSetRange(Int32, ICollection)

Copia os elementos de uma coleção em um intervalo de elementos no ArrayList.

System_CAPS_pubmethodSort()

Classifica os elementos em todo o ArrayList.

System_CAPS_pubmethodSort(IComparer)

Classifica os elementos em todo o ArrayList usando o comparador especificado.

System_CAPS_pubmethodSort(Int32, Int32, IComparer)

Classifica os elementos em um intervalo de elementos em ArrayList usando o comparador especificado.

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(ArrayList)

Retorna um wrapper ArrayList sincronizado (thread-safe).

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(IList)

Retorna um wrapper IList sincronizado (thread-safe).

System_CAPS_pubmethodToArray()

Copia os elementos do ArrayList em uma nova matriz Object.

System_CAPS_pubmethodToArray(Type)

Copia os elementos do ArrayList em uma nova matriz do tipo de elemento especificado.

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa o objeto atual.(Herdado de Object.)

System_CAPS_pubmethodTrimToSize()

Define a capacidade para o número real de elementos em ArrayList.

NomeDescrição
System_CAPS_pubmethodAsParallel()

Sobrecarregado. Habilita a paralelização de uma consulta.(Definido pelo ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Sobrecarregado. Converte um IEnumerable em um IQueryable.(Definido pelo Queryable.)

System_CAPS_pubmethodCast<TResult>()

Converte os elementos de um IEnumerable para o tipo especificado.(Definido pelo Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtra os elementos de um IEnumerable com base em um tipo especificado.(Definido pelo Enumerable.)

System_CAPS_noteObservação

Para exibir o código-fonte do .NET Framework para este tipo, consulte o Reference Source. Percorra o código-fonte online, baixe a referência para exibição offline e percorrer as fontes (incluindo atualizações e patches) durante a depuração; consulte instructions.

O ArrayList classe foi projetada para manter heterogêneas coleções de objetos. No entanto, ele não sempre oferece o melhor desempenho. Em vez disso, recomendamos o seguinte:

  • Para uma coleção heterogênea de objetos, use o List<Object> (em c#) ou List(Of Object) (no Visual Basic), digite.

  • Para uma coleção homogênea de objetos, use o List<T> classe.

Consulte a seção "Considerações de desempenho" o List<T> tópico de referência para uma discussão sobre o desempenho relativo dessas classes.

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

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

Para grandes ArrayList objetos, 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 configuração para true no ambiente de tempo de execução.

Elementos nesta coleção podem ser acessados usando um índice de inteiro. Índices nesta coleção são baseadas em zero.

O ArrayList coleção aceita null como um valor válido. Ele também permite elementos duplicados.

Usando matrizes multidimensionais como elementos em um ArrayList não há suporte para a coleção.

O exemplo de código a seguir mostra como criar e inicializar um ArrayList e como exibir 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   !

*/

Plataforma Universal do Windows
Disponível desde 10
.NET Framework
Disponível desde 1.1

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 thread-safe.

Um ArrayList pode dar suporte a vários leitores simultaneamente, desde que a coleção não é modificada. Para garantir a segurança de thread do ArrayList, todas as operações devem ser feitas por meio do wrapper retornado pelo Synchronized 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.

Retornar ao início
Mostrar: