Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

CollectionBase.Capacity-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft die Anzahl der Elemente ab, die die CollectionBase enthalten kann, oder legt diese fest.

Namespace:   System.Collections
Assembly:  mscorlib (in mscorlib.dll)

[ComVisibleAttribute(false)]
public int Capacity { get; set; }

Eigenschaftswert

Type: System.Int32

Die anfängliche Anzahl von Elementen, die die CollectionBase enthalten kann.

Exception Condition
ArgumentOutOfRangeException

Capacity Klicken Sie auf einen Wert festgelegt ist kleiner als Count.

OutOfMemoryException

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

Capacity die Anzahl der Elemente, die die CollectionBase speichern können. Count ist die Anzahl der Elemente, die tatsächlich in der CollectionBase.

Capacity ist immer größer als oder gleich Count. Wenn Count überschreitet Capacity beim Hinzufügen von Elementen, die Kapazität wird automatisch erhöht, indem erneut des internen Arrays zugewiesen werden, bevor die alten Elemente kopiert und die neuen Elemente hinzugefügt.

Die Kapazität kann verringert werden, durch Festlegen der Capacity Eigenschaft explizit. Wenn der Wert des Capacity explizit festgelegt ist, das interne Array ebenfalls neu reserviert, um die angegebene Kapazität aufzunehmen.

Das Abrufen des Werts dieser Eigenschaft ist ein o(1)-Vorgang. Festlegen der Eigenschaft ist eine O (n)-Vorgang, in dem n die neue Kapazität.

Universelle Windows-Plattform
Verfügbar seit 10
.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: