Condividi tramite


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

Int32

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 preallocati per l'archiviazione di elementi in questa raccolta, mentre la Count proprietà rappresenta il numero effettivo di elementi attualmente presenti nell'insieme. Il valore di Capacity è sempre pari almeno al valore di Count.

Quando gli elementi della raccolta appena aggiunti superano la capacità di raccolta, la capacità viene aumentata automaticamente per contenere gli elementi della raccolta appena aggiunti. L'aumento della capacità di raccolta comporta l'allocazione di slot di raccolta aggiuntivi, che comporta un sovraccarico delle prestazioni e della memoria. Usare la Capacity proprietà per ottimizzare la capacità di raccolta nei casi in cui il numero totale o massimo di elementi della raccolta è noto in anticipo. Utilizzare il TrimToSize metodo per fare in modo che la capacità della raccolta sia uguale al numero di raccolte corrente.

Si applica a

Vedi anche