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