Freigeben über


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

Int32

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 vorhanden sind. Der Wert ist immer mindestens so groß wie der Wert Capacity von Count.

Wenn neu hinzugefügte Auflistungselemente dazu führen, dass die Auflistungsanzahl die Sammlungskapazität überschreitet, wird die Kapazität automatisch erhöht, um die neu hinzugefügten Auflistungselemente zu erfüllen. Die Erhöhung der Sammlungskapazität umfasst die Zuweisung zusätzlicher Sammlungsplätze, die sowohl Leistung als auch Speicheraufwand verursachen. Verwenden Sie die Capacity Eigenschaft, um die Sammlungskapazität in Fällen zu optimieren, in denen die Gesamtzahl oder maximale Anzahl von Auflistungselementen im Voraus bekannt ist. Verwenden Sie die TrimToSize Methode, um die Sammlungskapazität mit der aktuellen Auflistungsanzahl gleichzulösen.

Gilt für

Siehe auch