IBufferWriter<T>.GetMemory(Int32) 方法

定义

命名空间:

System.Buffers

程序集:

System.Memory.dll

返回要向其中写入数据的 Memory<T>，且大小至少是 sizeHint 指定的请求大小。

public Memory<T> GetMemory (int sizeHint = 0);

abstract member GetMemory : int -> Memory<'T>

Public Function GetMemory (Optional sizeHint As Integer = 0) As Memory(Of T)

参数

sizeHint

Int32

返回的 Memory<T> 的长度下限。 如果为 0，返回非空缓冲区。

返回

Memory<T>

大小至少是 sizeHint 的 Memory<T>。 如果 sizeHint 是 0，返回非空缓冲区。

例外

OutOfMemoryException

请求的缓冲区大小不可用。

注解

不能保证连续调用将返回相同的缓冲区或相同大小的缓冲区。

这绝不能返回 Span<T>.Empty，但如果请求的缓冲区大小不可用，它可能会引发。

必须在调用 Advance 之后请求新的缓冲区，才能继续写入更多数据；无法写入到之前获取的缓冲区。