ArrayPool<T>.Return(T[], Boolean) メソッド

定義

名前空間:

System.Buffers

アセンブリ:

System.Runtime.dll

ソース:

ArrayPool.cs

同じ ArrayPool<T> インスタンスで前に Rent(Int32) メソッドを使って取得した配列を、プールに戻します。

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)

パラメーター

array

T[]

前に Rent(Int32) メソッドを使って取得した、プールに戻す必要があるバッファー。

clearArray

Boolean

再利用する前にバッファーの内容を消去する必要があるかどうかを示します。 clearArray が true に設定されている場合、プールを後で再利用できるようにバッファーを格納するときに、Return(T[], Boolean) メソッドはその内容の array をクリアして、後で Rent(Int32) メソッドを使う呼び出し元に以前の呼び出し元の内容が見えないようにします。 clearArray が false に設定されている場合、またはプールがバッファーを解放する場合は、配列の内容は変更されないままになります。

注釈

バッファーがプールに返されると、呼び出し元はバッファーのすべての所有権を放棄し、それを使用しないでください。 メソッドの特定の呼び出しから返される参照は、 Rent メソッドを 1 回だけ使用して Return 返す必要があります。 既定値 ArrayPool<T> は、返されたバッファーを再度レンタルするために保持することも、プールに既に十分なバッファーが格納されていると判断された場合は、返されたバッファーを解放することもできます。