IBufferWriter<T>.GetMemory(Int32) Método

Definición

Espacio de nombres:

System.Buffers

Ensamblado:

System.Memory.dll

Devuelve un objeto Memory<T> en el que escribir, que tiene al menos el tamaño solicitado (especificado por sizeHint).

public Memory<T> GetMemory (int sizeHint = 0);

abstract member GetMemory : int -> Memory<'T>

Public Function GetMemory (Optional sizeHint As Integer = 0) As Memory(Of T)

Parámetros

sizeHint

Int32

Longitud mínima del objeto Memory<T> devuelto. Si es 0, se devuelve un búfer no vacío.

Devoluciones

Memory<T>

Un objeto Memory<T> con al menos el tamaño sizeHint. Si sizeHint es 0, se devuelve un búfer no vacío.

Excepciones

OutOfMemoryException

El tamaño de búfer solicitado no está disponible.

Comentarios

No hay ninguna garantía de que las llamadas sucesivas devuelvan el mismo búfer o el mismo búfer de tamaño.

Esto nunca debe devolver Span<T>.Empty, pero puede iniciarse si el tamaño del búfer solicitado no está disponible.

Debe solicitar un nuevo búfer después de llamar a Advance para seguir escribiendo más datos; no puede escribir en un búfer que se haya obtenido anteriormente.