TableRowCollection.Capacity Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property Capacity As IntegerEigenschaftswert
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.
