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

Definição

Namespace:

System.Buffers

Assembly:

System.Memory.dll

Retorna um Memory<T> para gravar que é o tamanho mínimo solicitado ou superior (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

O comprimento mínimo de Memory<T> retornado. Se for 0, um buffer não vazio será retornado.

Retornos

Memory<T>

Um Memory<T> de tamanho mínimo sizeHint. Se sizeHint for 0, retornará um buffer não vazio.

Exceções

OutOfMemoryException

O tamanho do buffer solicitado não está disponível.

Comentários

Não há nenhuma garantia de que chamadas sucessivas retornarão o mesmo buffer ou o mesmo buffer de tamanho.

Isso nunca deve retornar Span<T>.Empty, mas poderá ser gerado se o tamanho do buffer solicitado não estiver disponível.

Você precisa solicitar um novo buffer depois de chamar Advance para continuar gravando mais dados; não é possível fazer uma gravação em um buffer previamente adquirido.