PipeWriter.GetSpan(Int32) 方法

定義

命名空間:

System.IO.Pipelines

組件:

System.IO.Pipelines.dll

套件:

System.IO.Pipelines v8.0.0

來源:

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) 後，您必須要求新的緩衝區以繼續寫入更多資料；您無法寫入先前取得的緩衝區。