IBufferWriter<T>.GetMemory(Int32) 方法

定義

命名空間:

System.Buffers

組件:

System.Memory.dll

傳回 Memory<T> 以寫入到至少為要求大小 (由 sizeHint指定) 的資料。

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

abstract member GetMemory : int -> Memory<'T>

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

參數

sizeHint

Int32

所傳回 Memory<T> 的長度下限。 若為 0，則會傳回非空的緩衝區。

傳回

Memory<T>

大小至少為 sizeHint 的 Memory<T>。 若 sizeHint 為 0，則會傳回非空緩衝區。

例外狀況

OutOfMemoryException

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

備註

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

這絕對不能傳回 ，但如果要求的緩衝區大小無法使用，它就會擲回 Span<T>.Empty。

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