CollectionBase.Capacity Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u het aantal elementen op of CollectionBase stelt u dit in.
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, setPublic Property Capacity As IntegerWaarde van eigenschap
Het aantal elementen dat het CollectionBase kan bevatten.
- Kenmerken
Uitzonderingen
Er is onvoldoende geheugen beschikbaar op het systeem.
Opmerkingen
Capacity is het aantal elementen dat het CollectionBase kan opslaan. Count is het aantal elementen dat zich daadwerkelijk in de CollectionBase.
Capacity is altijd groter dan of gelijk aan Count. Als Count de capaciteit wordt overschreden Capacity tijdens het toevoegen van elementen, wordt de capaciteit automatisch verhoogd door de interne matrix opnieuw te verplaatsen voordat u de oude elementen kopieert en de nieuwe elementen toevoegt.
De capaciteit kan worden verlaagd door de Capacity eigenschap expliciet in te stellen. Wanneer de waarde expliciet Capacity is ingesteld, wordt de interne matrix ook opnieuw toegewezen voor de opgegeven capaciteit.
Het ophalen van de waarde van deze eigenschap is een O(1) bewerking; het instellen van de eigenschap is een O(n) bewerking, waarbij n de nieuwe capaciteit zich bevindt.