PipeWriter.GetMemory(Int32) Método

Definição

Retorna uma Memory<T> na qual será feita a gravação que tenha o tamanho mínimo solicitado, conforme especificado pelo parâmetro sizeHint.Returns a Memory<T> to write to that is at least the requested size, as specified by the sizeHint parameter.

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)

Parâmetros

sizeHint
Int32

O comprimento mínimo de Memory<T> retornado.The minimum length of the returned Memory<T>. Se for 0, um buffer de memória não vazio de tamanho arbitrário será retornado.If 0, a non-empty memory buffer of arbitrary size is returned.

Retornos

Um buffer de memória de, pelo menos, sizeHint bytes.A memory buffer of at least sizeHint bytes. Se sizeHint for 0, retornará um buffer não vazio de tamanho arbitrário.If sizeHint is 0, returns a non-empty buffer of arbitrary size.

Implementações

Exceções

O tamanho do buffer solicitado não está disponível.The requested buffer size is not available.

Comentários

Não há nenhuma garantia de que as chamadas sucessivas retornarão o mesmo buffer ou o buffer de mesmo tamanho.There is no guarantee that successive calls will return the same buffer or the same-sized buffer.

Esse método nunca retorna Memory<T>.Empty, mas gera uma OutOfMemoryException se o tamanho do buffer solicitado não estiver disponível.This method never returns Memory<T>.Empty, but it throws an OutOfMemoryException if the requested buffer size is not available.

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.You must request a new buffer after calling Advance to continue writing more data; you cannot write to a previously acquired buffer.

Aplica-se a