PipeWriter.GetSpan(Int32) メソッド

定義

名前空間:

System.IO.Pipelines

アセンブリ:

System.IO.Pipelines.dll

パッケージ:

System.IO.Pipelines v8.0.0

ソース:

PipeWriter.cs

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

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)

パラメーター

sizeHint

Int32

返される Span<T> の最小の長さ。 0 の場合、任意のサイズの空でないバッファーが返されます。

戻り値

Span<Byte>

少なくとも sizeHint バイトのバッファー。 sizeHint が 0 の場合は、任意のサイズの空でないバッファーを返します。

実装

GetSpan(Int32)

例外

OutOfMemoryException

要求したバッファー サイズは使用できません。

注釈

連続する呼び出しで同じバッファーまたは同じサイズのバッファーが返される保証はありません。

このメソッドは を返 Span<T>.Emptyしませんが、要求されたバッファー サイズが使用できない場合は をスロー OutOfMemoryException します。

さらにデータの書き込みを続けるには、Advance(Int32) を呼び出した後に新しいバッファーを要求する必要があります。前に取得したバッファーに書き込むことはできません。