Freigeben über


TableRowGroupCollection.Capacity Eigenschaft

Definition

Ruft für diese Auflistung die vorab reservierte Kapazität für Auflistungselemente ab oder legt diese fest.

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

Eigenschaftswert

Die für diese Auflistung vorab reservierte Kapazität für Auflistungselemente. Der Standardwert ist 8.

Ausnahmen

Wird ausgelöst, wenn versucht wird, Capacity auf einen Wert festzulegen, der kleiner als der aktuelle Wert für Count ist.

Hinweise

Die Capacity -Eigenschaft stellt die Anzahl der vorab zugewiesenen Slots zum Speichern von Elementen in dieser Auflistung dar, während die Count -Eigenschaft die tatsächliche Anzahl von Elementen darstellt, die derzeit in der Auflistung enthalten sind. Der Wert von Capacity ist immer mindestens so groß wie der Wert von Count.

Wenn neu hinzugefügte Sammlungselemente dazu führen, dass die Sammlungsanzahl die Sammlungskapazität überschreitet, wird die Kapazität automatisch erhöht, um die neu hinzugefügten Sammlungselemente aufzunehmen. Das Erhöhen der Sammlungskapazität beinhaltet das Zuweisen zusätzlicher Sammlungsslots, was sowohl Leistung als auch Arbeitsspeicheraufwand verursacht. Verwenden Sie die Capacity -Eigenschaft, um die Sammlungskapazität in Fällen zu optimieren, in denen die Gesamt- oder maximale Anzahl von Sammlungselementen im Voraus bekannt ist. Verwenden Sie die TrimToSize -Methode, um die Sammlungskapazität mit der aktuellen Sammlungsanzahl zu entzerren.

Gilt für:

Weitere Informationen