ArrayList Construtores

Definição

Namespace:

System.Collections

Assemblies:

netstandard.dll, System.Runtime.dll

Inicializa uma nova instância da classe ArrayList.

Sobrecargas

Nome	Description
ArrayList()	Inicializa uma nova instância da ArrayList classe que está vazia e tem a capacidade inicial padrão.
ArrayList(ICollection)	Inicializa uma nova instância da ArrayList classe que contém elementos copiados da coleção especificada e que tem a mesma capacidade inicial que o número de elementos copiados.
ArrayList(Int32)	Inicializa uma nova instância da ArrayList classe que está vazia e tem a capacidade inicial especificada.

ArrayList()

Origem:

ArrayList.cs

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

public:
 ArrayList();

public ArrayList();

Public Sub New ()

Comentários

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 é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao ArrayList.

Este construtor é uma O(1) operação.

Confira também

• Capacity

ArrayList(ICollection)

Origem:

ArrayList.cs

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

public:
 ArrayList(System::Collections::ICollection ^ c);

public ArrayList(System.Collections.ICollection c);

new System.Collections.ArrayList : System.Collections.ICollection -> System.Collections.ArrayList

Public Sub New (c As ICollection)

Parâmetros

c

ICollection

Os ICollection elementos cujos elementos são copiados para a nova lista.

Exceções

ArgumentNullException

c é null.

RankException

c é uma matriz multidimensional.

Comentários

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 é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao ArrayList.

Os elementos são copiados na ArrayList mesma ordem em que são lidos pelo IEnumeratorICollection.

Esse construtor é uma O(n) operação, onde n está o número de elementos em c.

Confira também

• ICollection
• Capacity

ArrayList(Int32)

Origem:

ArrayList.cs

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

public:
 ArrayList(int capacity);

public ArrayList(int capacity);

new System.Collections.ArrayList : int -> System.Collections.ArrayList

Public Sub New (capacity As Integer)

Parâmetros

capacity

Int32

O número de elementos que a nova lista pode armazenar inicialmente.

Exceções

ArgumentOutOfRangeException

capacity é menor que zero.

Comentários

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 é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao ArrayList.

Esse construtor é uma O(n) operação, onde n está capacity.

Cuidado

Se capacity vier da entrada do usuário, prefira usar o construtor sem parâmetros e permitir que a coleção redimensione à medida que os elementos forem adicionados. Se você precisar usar um valor especificado pelo usuário, fixe-o a um limite razoável (por exemplo) Math.Clamp(untrustedValue, 0, 20)ou verifique se a contagem de elementos corresponde ao valor especificado.

Confira também

• Capacity