ArrayPool<T>.Return(T[], Boolean) Método

Definição

Namespace:

System.Buffers

Assembly:

System.Runtime.dll

Origem:

ArrayPool.cs

Retorna uma matriz para o pool que foi obtido anteriormente usando o método Rent(Int32) na mesma instância ArrayPool<T>.

public abstract void Return (T[] array, bool clearArray = false);

abstract member Return : 'T[] * bool -> unit

Public MustOverride Sub Return (array As T(), Optional clearArray As Boolean = false)

Parâmetros

array

T[]

Um buffer para retornar para o pool que foi obtido anteriormente usando o método Rent(Int32).

clearArray

Boolean

Indica se o conteúdo do buffer deve ser apagado antes da reutilização. Se clearArray for definido como true e se o pool for armazenar o buffer para permitir a reutilização subsequente, o método Return(T[], Boolean) limpará o conteúdo do array para que um chamador subsequente usando o método Rent(Int32) não veja o conteúdo do chamador anterior. Se clearArray for definido como false ou se o pool for liberar o buffer, o conteúdo da matriz permanecerá inalterado.

Comentários

Depois que um buffer é retornado ao pool, o chamador desiste de toda a propriedade do buffer e não deve usá-lo. A referência retornada de uma determinada chamada para o Rent método só deve ser retornada usando o Return método uma vez. O padrão ArrayPool<T> pode manter o buffer retornado para alugá-lo novamente ou pode liberar o buffer retornado se for determinado que o pool já tem buffers suficientes armazenados.