Dictionary<TKey,TValue>.EnsureCapacity(Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Гарантирует, что словарь может содержать до указанного количества записей без дальнейшего расширения его резервного хранилища.
public:
int EnsureCapacity(int capacity);public int EnsureCapacity(int capacity);member this.EnsureCapacity : int -> intPublic Function EnsureCapacity (capacity As Integer) As IntegerПараметры
- capacity
- Int32
Количество записей.
Возвращаемое значение
Текущая емкость Dictionary<TKey,TValue>объекта .
Исключения
capacity меньше 0.
Комментарии
Предостережение
Если capacity поступает из ввода пользователя, предпочесть изменить размер коллекции как элементы добавляются вместо вызова этого метода. Если необходимо использовать указанное пользователем значение, либо заклоните его в разумный предел (например, ) или убедитесь, Math.Clamp(untrustedValue, 0, 20)что число элементов соответствует указанному значению.
