TableColumnCollection.Capacity Proprietà

Definizione

Ottiene o imposta la capacità di elementi preallocati per questo insieme.Gets or sets the pre-allocated collection item capacity for this collection.

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.The pre-allocated collection item capacity for this collection. Il valore predefinito è 8.The default value is 8.

Eccezioni

Generato quando si tenta di impostare Capacity su un valore inferiore al valore corrente di Count.Raised when an attempt is made to set Capacity to a value that is less than the current value of Count.

Commenti

La Capacity proprietà rappresenta il numero di slot preallocati per l'archiviazione di elementi in questa raccolta, Count mentre la proprietà rappresenta il numero effettivo di elementi attualmente presenti nella raccolta.The Capacity property represents the number of pre-allocated slots for storing items in this collection, whereas the Count property represents the actual number of items currently in the collection. Il valore di Capacity è sempre almeno uguale al valore di. CountThe value of Capacity is always at least as large as the value of Count.

Quando gli elementi della raccolta appena aggiunti comportano il superamento della capacità della raccolta da parte del conteggio delle raccolte, la capacità viene aumentata automaticamente per contenere gli elementi della raccolta appena aggiunti.When newly added collection items cause the collection count to exceed the collection capacity, the capacity is automatically increased to accommodate the newly added collection items. L'aumento della capacità della raccolta comporta l'allocazione di slot di raccolta aggiuntivi, che determinano il sovraccarico delle prestazioni e della memoria.Increasing the collection capacity involves allocating additional collection slots, which incurs both performance and memory overhead. 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.Use the Capacity property to optimize the collection capacity in cases where the total or maximum number of collection items is known in advance. Utilizzare il TrimToSize metodo per fare in modo che la capacità della raccolta venga uguagliata con il conteggio di raccolta corrente.Use the TrimToSize method to cause the collection capacity to equalized with the current collection count.

Si applica a

Vedi anche