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

Definition

Namespace:

System.Buffers

Assembly:

System.Runtime.dll

Source:

ArrayPool.cs

Ein Array wird dem Pool zurückgegeben, das zuvor mithilfe der Rent(Int32)-Methode auf der gleichen ArrayPool<T>-Instanz abgerufen wurde.

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)

Parameter

array

T[]

Ein Puffer, der dem Pool zurückgegeben werden soll, der zuvor mithilfe der Rent(Int32)-Methode abgerufen wurde.

clearArray

Boolean

Gibt an, ob die Inhalte des Puffers vor der Wiederverwendung gelöscht werden sollen. Wenn clearArray auf true festgelegt ist, und wenn der Pool den Puffer für eine weitere Wiederverwendung speichert, löscht die Methode Return(T[], Boolean) die Inhalte des array-Objekts, sodass der folgende Aufrufer, der die Rent(Int32)-Methode verwendet, den Inhalt des vorherigen Aufrufers nicht sieht. Wenn clearArray auf false festgelegt ist, oder wenn der Pool den Puffer freigibt, bleiben die Inhalte des Arrays unverändert.

Hinweise

Sobald ein Puffer an den Pool zurückgegeben wurde, gibt der Aufrufer den gesamten Besitz des Puffers auf und darf ihn nicht verwenden. Der von einem bestimmten Aufruf der Rent -Methode zurückgegebene Verweis darf nur einmal mit der Return -Methode zurückgegeben werden. Der Standardwert ArrayPool<T> kann den zurückgegebenen Puffer beibehalten, um ihn erneut zu mieten, oder er gibt den zurückgegebenen Puffer frei, wenn festgestellt wird, dass im Pool bereits genügend Puffer gespeichert sind.