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