ArrayPool<T>.Return(T[], Boolean) 方法

定義

命名空間:

System.Buffers

組件:

System.Runtime.dll

來源:

ArrayPool.cs

將先前使用 Rent(Int32) 方法在相同的 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)

參數

array

T[]

要傳回集區的緩衝區，它先前是使用 Rent(Int32) 方法取得。

clearArray

Boolean

指出是否應該先清除緩衝區內容再重複使用。 如果 clearArray 設為 true，且集區會儲存緩衝區以便後續能夠重複使用，則 Return(T[], Boolean) 方法會清除其內容的 array，不讓後續使用 Rent(Int32) 方法的呼叫者看到前一位呼叫者的內容。 如果 clearArray 設為 false 或集區會釋出緩衝區，則陣列的內容保持不變。

備註

一旦緩衝區傳回集區，呼叫端就會放棄緩衝區的所有擁有權，且不得使用它。 從指定呼叫方法傳回的 Rent 參考，只能使用 Return 方法一次傳回。 默認值 ArrayPool<T> 可能會保留到傳回的緩衝區，以便再次租用，或者如果判斷集區已儲存足夠的緩衝區，則可能會釋放傳回的緩衝區。