Condividi tramite


CollectionBase.Capacity Proprietà

Definizione

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; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, set
Public Property Capacity As Integer

Valore della proprietà

Numero degli elementi che CollectionBase può contenere.

Attributi

Eccezioni

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

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à.

Si applica a

Vedi anche