ArrayList.Capacity Propriedade

Definição

Obtém ou define o número de elementos que o ArrayList pode conter.Gets or sets the number of elements that the ArrayList can contain.

public:
 virtual property int Capacity { int get(); void set(int value); };
public virtual int Capacity { get; set; }
member this.Capacity : int with get, set
Public Overridable Property Capacity As Integer

Valor da propriedade

O número de elementos que o ArrayList pode conter.The number of elements that the ArrayList can contain.

Exceções

Capacity é definido como um valor menor que Count.Capacity is set to a value that is less than Count.

Não há memória suficiente disponível no sistema.There is not enough memory available on the system.

Comentários

Capacity é o número de elementos que o ArrayList pode armazenar.Capacity is the number of elements that the ArrayList can store. Count é o número de elementos que estão na verdade na ArrayList.Count is the number of elements that are actually in the ArrayList.

Capacity sempre é maior ou igual a Count.Capacity is always greater than or equal to Count. Se Count exceder Capacity ao adicionar elementos, a capacidade será aumentada automaticamente com a realocação da matriz interna antes de copiar os elementos antigos e adicionar os novos elementos.If Count exceeds Capacity while adding elements, the capacity is automatically increased by reallocating the internal array before copying the old elements and adding the new elements.

A capacidade pode ser diminuída chamando TrimToSize ou definindo a propriedade Capacity explicitamente.The capacity can be decreased by calling TrimToSize or by setting the Capacity property explicitly. Quando o valor de Capacity é definido explicitamente, a matriz interna também é realocada para acomodar a capacidade especificada.When the value of Capacity is set explicitly, the internal array is also reallocated to accommodate the specified capacity.

A recuperação do valor dessa propriedade é uma operação O(1); definir a propriedade é uma operação O(n), em que n é a nova capacidade.Retrieving the value of this property is an O(1) operation; setting the property is an O(n) operation, where n is the new capacity.

Aplica-se a

Veja também