Dictionary<TKey,TValue>.EnsureCapacity(Int32) Methode
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.
Zorgt ervoor dat de woordenlijst maximaal een opgegeven aantal vermeldingen kan bevatten zonder verdere uitbreiding van de back-upopslag.
public:
int EnsureCapacity(int capacity);
public int EnsureCapacity(int capacity);
member this.EnsureCapacity : int -> int
Public Function EnsureCapacity (capacity As Integer) As Integer
Parameters
- capacity
- Int32
Het aantal vermeldingen.
Retouren
De huidige capaciteit van de Dictionary<TKey,TValue>.
Uitzonderingen
capacity is kleiner dan 0.
Opmerkingen
Caution
Als capacity deze afkomstig is van gebruikersinvoer, geeft u de voorkeur aan het formaat van de verzameling zelf als elementen worden toegevoegd in plaats van deze methode aan te roepen. Als u een door de gebruiker opgegeven waarde moet gebruiken, kunt u deze vastzetten op een redelijke limiet (bijvoorbeeld Math.Clamp(untrustedValue, 0, 20)) of controleren of het aantal elementen overeenkomt met de opgegeven waarde.