Freigeben über


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

Definition

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

Nachdem 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 mithilfe 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 der Pool bereits über genügend Puffer gespeichert ist.

Gilt für: