SortedList.Capacity Eigenschaft

Definition

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Quelle:

SortedList.cs

Ruft die Kapazität eines SortedList-Objekts ab 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

Int32

Die Anzahl von Elementen, die das SortedList-Objekt enthalten kann.

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Wert ist kleiner als die derzeitige Anzahl der Elemente im SortedList-Objekt.

OutOfMemoryException

Im System ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Capacity gibt die Anzahl der Elemente an, die das SortedList Objekt speichern kann. Count ist die Anzahl der Elemente, die tatsächlich in enthalten SortedListsind.

Capacity ist immer größer 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 aufzunehmen.

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.

Weitere Informationen

• TrimToSize()