CollectionBase.Capacity Eigenschaft

Definition

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

public:
 property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, set
Public Property Capacity As Integer

Eigenschaftswert

Int32

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

Attribute

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 CollectionBase gespeichert werden können.Capacity is the number of elements that the CollectionBase can store. Count die Anzahl der Elemente, die tatsächlich in der sind CollectionBase .Count is the number of elements that are actually in the CollectionBase.

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 die-Eigenschaft explizit festgelegt wird Capacity .The capacity can be decreased 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:

Weitere Informationen