PipeWriter.GetMemory(Int32) メソッド

定義

名前空間:

System.IO.Pipelines

アセンブリ:

System.IO.Pipelines.dll

パッケージ:

System.IO.Pipelines v8.0.0

ソース:

PipeWriter.cs

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

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