Язык

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

Применяется к