CollectionBase.Capacity Egenskap

Definition

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

Capacity är inställt på ett värde som är mindre än Count.

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.

Gäller för

Se även