CollectionBase.Capacity Proprietà

Definizione

Spazio dei nomi:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Source:

CollectionBase.cs

Ottiene o imposta il numero di elementi che CollectionBase può contenere.

public:
 property int Capacity { int get(); void set(int value); };

public int Capacity { get; set; }

member this.Capacity : int with get, set

Public Property Capacity As Integer

Valore della proprietà

Int32

Numero degli elementi che CollectionBase può contenere.

Eccezioni

ArgumentOutOfRangeException

L'oggetto Capacity è impostato su un valore minore di Count.

OutOfMemoryException

La memoria disponibile nel sistema non è sufficiente.

Commenti

Capacity è il numero di elementi che possono CollectionBase archiviare. Count è il numero di elementi effettivamente presenti nell'oggetto CollectionBase.

Capacity è sempre maggiore o uguale a Count. Se Count supera Capacity l'aggiunta di elementi, la capacità viene aumentata automaticamente riallocare la matrice interna prima di copiare gli elementi precedenti e aggiungere i nuovi elementi.

La capacità può essere ridotta impostando in modo esplicito la Capacity proprietà. Quando il valore di Capacity è impostato in modo esplicito, la matrice interna viene riallocata anche per supportare la capacità specificata.

Il recupero del valore di questa proprietà è un'operazione. L'impostazione della proprietà è un'operazione O(1)O(n) , dove n è la nuova capacità.

Vedi anche

• Count