PipeWriter.GetMemory(Int32) 方法

定義

命名空間:

System.IO.Pipelines

組件:

System.IO.Pipelines.dll

套件:

System.IO.Pipelines v8.0.0

來源:

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