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

定义

命名空间:

System.Buffers

程序集:

System.Runtime.dll

Source:

ArrayPool.cs

要返回给先前在同一 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> 可能会保留返回的缓冲区以再次租用它，或者，如果确定池中已存储足够的缓冲区，则可能会释放返回的缓冲区。