TableCellCollection.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 Kapazität 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 präallokatierten Slots für das 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 zu gleichstellen.