PipeWriter.GetSpan(Int32) Метод

Определение

Пространство имен:

System.IO.Pipelines

Сборка:

System.IO.Pipelines.dll

Пакет:

System.IO.Pipelines v8.0.0

Исходный код:

PipeWriter.cs

Возвращает Span<T> для записи минимального запрошенного размера (определяется параметром sizeHint).

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) нужно запросить новый буфер. Производить запись в ранее полученный буфер нельзя.