TableCellCollection.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 de vooraf toegewezen verzamelingsitemcapaciteit voor deze verzameling op of stelt u deze in.
public:
property int Capacity { int get(); void set(int value); };public int Capacity { get; set; }member this.Capacity : int with get, setPublic Property Capacity As IntegerWaarde van eigenschap
De vooraf toegewezen capaciteit van het verzamelingsitem voor deze verzameling. De standaardwaarde is 8.
Uitzonderingen
Wordt gegenereerd wanneer een poging wordt gedaan om in te stellen Capacity op een waarde die kleiner is dan de huidige waarde van Count.
Opmerkingen
De Capacity eigenschap vertegenwoordigt het aantal vooraf toegewezen sites voor het opslaan van items in deze verzameling, terwijl de Count eigenschap het werkelijke aantal items vertegenwoordigt dat zich momenteel in de verzameling bevindt. De waarde is Capacity altijd minstens zo groot als de waarde van Count.
Wanneer nieuw toegevoegde verzamelingsitems ervoor zorgen dat het aantal verzamelingen de verzamelingscapaciteit overschrijdt, wordt de capaciteit automatisch verhoogd om de nieuw toegevoegde verzamelingsitems toe te passen. Het verhogen van de verzamelingscapaciteit omvat het toewijzen van extra verzamelingssites, wat zowel prestaties als geheugenoverhead met zich meebrengt. Gebruik de Capacity eigenschap om de verzamelingscapaciteit te optimaliseren in gevallen waarin het totale of maximum aantal verzamelingsitems van tevoren bekend is. Gebruik de TrimToSize methode om ervoor te zorgen dat de verzamelingscapaciteit gelijk is aan het huidige aantal verzamelingen.
