ArrayList.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 die Anzahl der Elemente ab, die die ArrayList enthalten kann, oder legt diese fest.
public:
virtual property int Capacity { int get(); void set(int value); };
public virtual int Capacity { get; set; }
member this.Capacity : int with get, set
Public Overridable Property Capacity As Integer
Eigenschaftswert
Die anfängliche Anzahl von Elementen, die die ArrayList enthalten kann.
Ausnahmen
Im System ist nicht genügend Arbeitsspeicher verfügbar.
Hinweise
Capacity ist die Anzahl der Elemente, die von ArrayList gespeichert werden können. Count ist die Anzahl der Elemente, die sich tatsächlich in der ArrayListbefinden.
Capacity ist immer größer als oder gleich Count. Wenn Count beim Hinzufügen von Elementen überschritten Capacity wird, wird die Kapazität automatisch erhöht, indem das interne Array neu zugeordnet wird, bevor die alten Elemente kopiert und die neuen Elemente hinzugefügt werden.
Die Kapazität kann durch Aufrufen TrimToSize oder explizites Festlegen der Capacity -Eigenschaft verringert werden. Wenn der Wert von Capacity explizit festgelegt wird, wird auch das interne Array neu zugeordnet, um die angegebene Kapazität zu berücksichtigen.
Das Abrufen des Werts dieser Eigenschaft ist ein O(1)
Vorgang. Das Festlegen der Eigenschaft ist ein O(n)
Vorgang, wobei n
die neue Kapazität ist.