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

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