CollectionBase.Capacity Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger antalet element som CollectionBase kan innehålla.
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
Egenskapsvärde
Antalet element som CollectionBase kan innehålla.
- Attribut
Undantag
Det finns inte tillräckligt med minne i systemet.
Kommentarer
Capacity är antalet element som CollectionBase kan lagras. Count är antalet element som faktiskt finns i CollectionBase.
Capacity är alltid större än eller lika med Count. Om Count överskrider när element läggs till ökas Capacity kapaciteten automatiskt genom att den interna matrisen omfördelas innan de gamla elementen kopieras och de nya elementen läggs till.
Kapaciteten kan minskas genom att uttryckligen ange egenskapen Capacity . När värdet Capacity för anges explicit omallokeras även den interna matrisen så att den passar den angivna kapaciteten.
Att hämta värdet för den här egenskapen är en O(1) åtgärd. Att ange egenskapen är en O(n) åtgärd, där n är den nya kapaciteten.