Queue<T>.EnsureCapacity(Int32) Método

Definição

Namespace:

System.Collections.Generic

Assemblies:

netstandard.dll, System.Collections.dll

Origem:

Queue.cs

Garante que a capacidade dessa fila seja pelo menos a especificada capacity. Se a capacidade atual for menor que capacity, ela será aumentada para pelo menos a especificada capacity.

public:
 int EnsureCapacity(int capacity);

public int EnsureCapacity(int capacity);

member this.EnsureCapacity : int -> int

Public Function EnsureCapacity (capacity As Integer) As Integer

Parâmetros

capacity

Int32

A capacidade mínima a ser assegurada.

Retornos

Int32

A nova capacidade dessa fila.

Comentários

Cuidado

Se capacity vier da entrada do usuário, prefira permitir que a coleção se redimensione à medida que os elementos são adicionados em vez de chamar esse método. Se você precisar usar um valor especificado pelo usuário, fixe-o a um limite razoável (por exemplo) Math.Clamp(untrustedValue, 0, 20)ou verifique se a contagem de elementos corresponde ao valor especificado.