Dictionary<TKey,TValue>.EnsureCapacity(Int32) Methode

Definitie

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.

Van toepassing op