Dictionary<TKey,TValue>.EnsureCapacity(Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Assicura che il dizionario possa contenere fino a un numero specificato di voci senza ulteriore espansione dell'archiviazione di backup.
public:
int EnsureCapacity(int capacity);public int EnsureCapacity(int capacity);member this.EnsureCapacity : int -> intPublic Function EnsureCapacity (capacity As Integer) As IntegerParametri
- capacity
- Int32
Numero di voci.
Restituisce
Capacità corrente dell'oggetto Dictionary<TKey,TValue>.
Eccezioni
capacity è minore di 0.
Commenti
Attenzione
Se capacity proviene dall'input dell'utente, preferire lasciare che la raccolta venga ridimensionata man mano che vengono aggiunti elementi anziché chiamare questo metodo. Se è necessario usare un valore specificato dall'utente, bloccarlo a un limite ragionevole (ad esempio, Math.Clamp(untrustedValue, 0, 20)) o verificare che il numero di elementi corrisponda al valore specificato.
