Dictionary<TKey,TValue>.EnsureCapacity(Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt sicher, dass das Wörterbuch bis zu einer bestimmten Anzahl von Einträgen speichern kann, ohne dass der Sicherungsspeicher weiter erweitert wird.
public:
int EnsureCapacity(int capacity);public int EnsureCapacity(int capacity);member this.EnsureCapacity : int -> intPublic Function EnsureCapacity (capacity As Integer) As IntegerParameter
- capacity
- Int32
Die Anzahl der Einträge.
Gibt zurück
Die aktuelle Kapazität der Dictionary<TKey,TValue>.
Ausnahmen
capacity ist kleiner als 0.
Hinweise
Vorsicht
Wenn capacity sie von Benutzereingaben stammt, sollten Sie es vorziehen, die Größe der Sammlung selbst zu ändern, da Elemente hinzugefügt werden, anstatt diese Methode aufzurufen. Wenn Sie einen vom Benutzer angegebenen Wert verwenden müssen, setzen Sie ihn entweder auf einen angemessenen Grenzwert (z. B. ) oder stellen Sie sicher, Math.Clamp(untrustedValue, 0, 20)dass die Elementanzahl mit dem angegebenen Wert übereinstimmt.
