CollectionBase.Capacity CollectionBase.Capacity CollectionBase.Capacity CollectionBase.Capacity Property

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); };
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
Public Property Capacity As Integer

Eigenschaftswert

Die anfängliche Anzahl von Elementen, die die CollectionBase enthalten kann.The number of elements that the CollectionBase 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.

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

Hinweise

Capacity die Anzahl der Elemente, die die CollectionBase speichern können.Capacity is the number of elements that the CollectionBase can store. Count ist die Anzahl der Elemente, die in der 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 überschreitet Capacity beim Hinzufügen von Elementen, die Kapazität wird automatisch erhöht, Neuzuordnen des internen Arrays vor dem Kopieren der alten und die neuen Elemente hinzugefügt.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, durch Festlegen der Capacity Eigenschaft explizit.The capacity can be decreased by setting the Capacity property explicitly. Wenn der Wert des Capacity explizit festgelegt ist, das interne Array wird auch die zur Aufnahme die angegebene Kapazität neu zugewiesen.When the value of Capacity is set explicitly, the internal array is also reallocated to accommodate the specified capacity.

Abrufen des Werts dieser Eigenschaft ist ein o(1)-Vorgang. Festlegen der Eigenschaft ist eine O (n)-Vorgang, in denen n ist die neue Kapazität.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