Dictionary<TKey,TValue>.EnsureCapacity(Int32) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ser till att ordlistan kan innehålla upp till ett angivet antal poster utan ytterligare expansion av dess lagring.
public:
int EnsureCapacity(int capacity);public int EnsureCapacity(int capacity);member this.EnsureCapacity : int -> intPublic Function EnsureCapacity (capacity As Integer) As IntegerParametrar
- capacity
- Int32
Antalet poster.
Returer
Den aktuella kapaciteten för Dictionary<TKey,TValue>.
Undantag
capacity är mindre än 0.
Kommentarer
Caution
Om capacity det kommer från användarindata föredrar du att låta samlingen ändra storlek när element läggs till i stället för att anropa den här metoden. Om du måste använda ett användarangivet värde kan du antingen klämma fast det till en rimlig gräns (till exempel Math.Clamp(untrustedValue, 0, 20)) eller kontrollera att elementantalet matchar det angivna värdet.