GC.CollectionCount(Int32) Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna o número de vezes em que ocorreu a coleta de lixo para a geração de objetos especificada.

public:
 static int CollectionCount(int generation);

public static int CollectionCount (int generation);

static member CollectionCount : int -> int

Public Shared Function CollectionCount (generation As Integer) As Integer

Parâmetros

generation: Int32

A geração de objetos para a qual a contagem de coletas de lixo deve ser determinada.

Retornos

Int32

O número de vezes que a coleta de lixo ocorreu para a geração especificada desde que o processo foi iniciado.

Exceções

ArgumentOutOfRangeException

generation é menor que 0.

Comentários

Se você implementar seu próprio gerenciamento de recursos, talvez seja necessário forçar a coleta de lixo periodicamente chamando o Collect método. Como essa é uma operação cara, você pode melhorar o desempenho ignorando a chamada quando uma coleta de lixo ocorreu recentemente. Salve o valor retornado CollectionCount imediatamente após a chamada Collect. Na próxima vez que você precisar chamar Collect, compare o valor atual retornado pelo CollectionCount valor salvo. Se os dois valores forem iguais, nenhuma coleção ocorreu nesse ínterim e é razoável chamar Collect novamente.

Aplica-se a