Condividi tramite


TableRowCollection.Capacity Proprietà

Definizione

Ottiene o imposta la capacità di elementi preallocati per questo insieme.

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à

Capacità di elementi preallocati per questo insieme. Il valore predefinito è 8.

Eccezioni

Generato quando si tenta di impostare Capacity su un valore inferiore al valore corrente di Count.

Commenti

La Capacity proprietà rappresenta il numero di slot pre-allocati per l'archiviazione degli elementi in questa raccolta, mentre la Count proprietà rappresenta il numero effettivo di elementi attualmente presenti nella raccolta. Il valore di Capacity è sempre uguale al valore di Count.

Quando gli elementi della raccolta appena aggiunti superano la capacità della raccolta, la capacità viene aumentata automaticamente per soddisfare gli elementi della raccolta appena aggiunti. L'aumento della capacità di raccolta comporta l'allocazione di slot di raccolta aggiuntivi, che comporta sia il sovraccarico delle prestazioni che del sovraccarico della memoria. Utilizzare la Capacity proprietà per ottimizzare la capacità della raccolta nei casi in cui il numero totale o massimo di elementi della raccolta è noto in anticipo. Utilizzare il TrimToSize metodo per causare l'equalizzazione della capacità della raccolta con il conteggio della raccolta corrente.

Si applica a

Vedi anche