Dictionary<TKey,TValue>.EnsureCapacity(Int32) Yöntem

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Collections.dll

Kaynak:

Dictionary.cs

Sözlüğün, yedekleme depolama alanını daha fazla genişletmeden belirtilen sayıda girdiyi tutabilmesini sağlar.

public:
 int EnsureCapacity(int capacity);

public int EnsureCapacity(int capacity);

member this.EnsureCapacity : int -> int

Public Function EnsureCapacity (capacity As Integer) As Integer

Parametreler

capacity

Int32

Girdi sayısı.

Döndürülenler

Int32

öğesinin Dictionary<TKey,TValue>geçerli kapasitesi.

Özel durumlar

ArgumentOutOfRangeException

capacity 0'dan küçüktür.

Açıklamalar

Dikkat

Kullanıcı girişinden geliyorsa capacity , bu yöntemi çağırmak yerine öğeler eklendikçe koleksiyonun kendisini yeniden boyutlandırmasını tercih edin. Kullanıcı tarafından belirtilen bir değer kullanmanız gerekiyorsa, bunu makul bir sınıra (örneğin, Math.Clamp(untrustedValue, 0, 20)) sıkıştırın veya öğe sayısının belirtilen değerle eşleşip eşleşmediğini doğrulayın.