Dictionary<TKey,TValue>.EnsureCapacity(Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Garante que o dicionário pode armazenar até um número especificado de entradas sem qualquer expansão adicional do seu armazenamento de suporte.
public:
int EnsureCapacity(int capacity);public int EnsureCapacity(int capacity);member this.EnsureCapacity : int -> intPublic Function EnsureCapacity (capacity As Integer) As IntegerParâmetros
- capacity
- Int32
O número de entradas.
Devoluções
A capacidade atual do Dictionary<TKey,TValue>.
Exceções
capacity é inferior a 0.
Observações
Atenção
Se capacity vier de input do utilizador, prefira deixar a coleção redimensionar-se à medida que os elementos são adicionados em vez de chamar este método. Se tiver de usar um valor especificado pelo utilizador, ou limite-o a um limite razoável (por exemplo, Math.Clamp(untrustedValue, 0, 20)) ou verifique se a contagem de elementos corresponde ao valor especificado.
