PipeWriter.GetSpan(Int32) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

傳回 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)

所傳回 Span<T> 的長度下限。如果為 0，則會傳回任意大小的非空白緩衝區。

Span<Byte>

最少 sizeHint 位元組的緩衝區。如果 sizeHint 為 0，則會傳回任意大小的非空白緩衝區。

GetSpan(Int32)

要求的緩衝區大小無法使用。

不保證後續呼叫會傳回相同的緩衝區或相同大小的緩衝區。

這個方法永遠不會傳 Span<T>.Empty回，但如果要求的緩衝區大小無法使用，則會擲回 OutOfMemoryException 。

呼叫 Advance(Int32) 後，您必須要求新的緩衝區以繼續寫入更多資料；您無法寫入先前取得的緩衝區。