SortedList<TKey,TValue>.Capacity Eigenschaft

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

SortedList.cs

Ruft die Anzahl der Elemente ab, die die SortedList<TKey,TValue> enthalten kann, oder legt diese fest.

public:
 property int Capacity { int get(); void set(int value); };

public int Capacity { get; set; }

member this.Capacity : int with get, set

Public Property Capacity As Integer

Eigenschaftswert

Int32

Die anfängliche Anzahl von Elementen, die die SortedList<TKey,TValue> enthalten kann.

Ausnahmen

ArgumentOutOfRangeException

Capacity ist auf einen Wert festgelegt, der kleiner als Count ist.

OutOfMemoryException

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

Hinweise

Capacity gibt die Anzahl der Elemente an, die gespeichert SortedList<TKey,TValue> werden können. Count ist die Anzahl der Elemente, die tatsächlich in enthalten SortedList<TKey,TValue>sind.

Capacity ist immer größer oder gleich Count. Wenn Count beim Hinzufügen von Elementen überschritten Capacity wird, wird die Kapazität erhöht, indem das interne Array automatisch neu zugewiesen wird, bevor die alten Elemente kopiert und die neuen Elemente hinzugefügt werden.

Die Kapazität kann durch Aufrufen TrimExcess 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. Die Einstellung der Eigenschaft ist ein O()n-Vorgang, wobei n die neue Kapazität ist.

Weitere Informationen

• Count
• TrimExcess()