ArrayPool<T>.Return(T[], Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
要返回给先前在同一 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 引用只能使用 Return 方法返回一次。 默认值 ArrayPool<T> 可能会保留返回的缓冲区以再次租用它,或者,如果确定池中已存储足够的缓冲区,则可能会释放返回的缓冲区。