IBufferWriter<T>.GetMemory(Int32) メソッド

定義

名前空間:

System.Buffers

アセンブリ:

System.Memory.dll

少なくとも要求されたサイズを持つ (sizeHint で指定します)、書き込み先の Memory<T> を返します。

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 を呼び出した後に新しいバッファーを要求する必要があります。前に取得したバッファーに書き込むことはできません。