PipeWriter.GetSpan(Int32) 方法

定义

命名空间:

System.IO.Pipelines

程序集:

System.IO.Pipelines.dll

包:

System.IO.Pipelines v8.0.0

Source:

PipeWriter.cs

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

public abstract Span<byte> GetSpan (int sizeHint = 0);

abstract member GetSpan : int -> Span<byte>

Public MustOverride Function GetSpan (Optional sizeHint As Integer = 0) As Span(Of Byte)

参数

sizeHint

Int32

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

返回

Span<Byte>

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

实现

GetSpan(Int32)

例外

OutOfMemoryException

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

注解

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

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

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