PipeWriter.GetMemory(Int32) 方法

定义

命名空间:

System.IO.Pipelines

程序集:

System.IO.Pipelines.dll

包:

System.IO.Pipelines v8.0.0

Source:

PipeWriter.cs

返回要写入到的 Memory<T>，其大小按 sizeHint 参数指定至少为所请求的大小。

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

abstract member GetMemory : int -> Memory<byte>

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

参数

sizeHint

Int32

返回的 Memory<T> 的长度下限。 如果为 0，则返回任意大小的非空内存缓冲区。

返回

Memory<Byte>

至少 sizeHint 字节的内存缓冲区。 如果 sizeHint 是 0，则返回任意大小的非空缓冲区。

实现

GetMemory(Int32)

例外

OutOfMemoryException

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

注解

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

此方法从不返回 Memory<T>.Empty，但如果请求的缓冲区大小不可用，它将引发 OutOfMemoryException 。

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