PipeWriter.GetSpan(Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает 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, возвращается непустой буфер произвольного размера.
Возвращаемое значение
Буфер размером не менее sizeHint байтов. Если значение sizeHint равно 0, возвращается непустой буфер произвольного размера.
Реализации
Исключения
Запрошенный размер буфера недоступен.
Комментарии
Нет никакой гарантии, что последовательные вызовы будут возвращать тот же буфер или буфер одинакового размера.
Этот метод никогда не возвращает Span<T>.Empty, но вызывает исключение , OutOfMemoryException если запрошенный размер буфера недоступен.
Чтобы продолжить запись данных, после вызова Advance(Int32) нужно запросить новый буфер. Производить запись в ранее полученный буфер нельзя.