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