ArrayPool<T>.Return(T[], Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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.
