ArrayList.Capacity Eigenschaft

Definition

Ruft die Anzahl der Elemente ab, die die ArrayList enthalten kann, oder legt diese fest.Gets or sets the number of elements that the ArrayList can contain.

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

Int32

Die anfängliche Anzahl von Elementen, die die ArrayList enthalten kann.The number of elements that the ArrayList can contain.

Ausnahmen

Capacity ist auf einen Wert festgelegt, der kleiner als Count ist.Capacity is set to a value that is less than Count.

Im System ist nicht genügend Arbeitsspeicher verfügbar.There is not enough memory available on the system.

Hinweise

Capacity die Anzahl der Elemente, die von der ArrayList gespeichert werden können.Capacity is the number of elements that the ArrayList can store. Count die Anzahl der Elemente, die tatsächlich in der sind ArrayList .Count is the number of elements that are actually in the ArrayList.

Capacity ist immer größer als oder gleich Count .Capacity is always greater than or equal to Count. Wenn Count Capacity beim Hinzufügen von Elementen überschreitet, wird die Kapazität automatisch erhöht, indem das interne Array neu zugewiesen wird, bevor die alten Elemente kopiert und die neuen Elemente hinzugefügt werden.If Count exceeds Capacity while adding elements, the capacity is automatically increased by reallocating the internal array before copying the old elements and adding the new elements.

Die Kapazität kann verringert werden, indem Sie aufrufen TrimToSize oder indem Sie die- Capacity Eigenschaft explizit festlegen.The capacity can be decreased by calling TrimToSize or by setting the Capacity property explicitly. Wenn der Wert von Capacity explizit festgelegt wird, wird das interne Array ebenfalls neu zugeordnet, um der angegebenen Kapazität Rechnung zu tragen.When the value of Capacity is set explicitly, the internal array is also reallocated to accommodate the specified capacity.

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.Retrieving the value of this property is an O(1) operation; setting the property is an O(n) operation, where n is the new capacity.

Gilt für:

Siehe auch