CollectionBase.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 CollectionBase enthalten kann, oder legt diese fest.
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
Die anfängliche Anzahl von Elementen, die die CollectionBase enthalten kann.
- Attribute
Ausnahmen
Im System ist nicht genügend Arbeitsspeicher verfügbar.
Hinweise
Capacity ist die Anzahl der Elemente, die der CollectionBase Speicher speichern kann. Count ist die Anzahl der Elemente, die tatsächlich in der CollectionBase.
Capacity ist immer größer oder gleich Count. Wenn Count das Hinzufügen von Elementen überschritten Capacity wird, wird die Kapazität automatisch erhöht, indem das interne Array neu sortiert wird, bevor die alten Elemente kopiert und die neuen Elemente hinzugefügt werden.
Die Kapazität kann verringert werden, indem die Capacity Eigenschaft explizit festgelegt wird. Wenn der Wert Capacity explizit festgelegt wird, wird das interne Array auch neu zugewiesen, 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
es sich um die neue Kapazität handelt.