PipeWriter.GetSpan(Int32) Método

Definição

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

public abstract Span<byte> GetSpan (int sizeHint = 0);
abstract member GetSpan : int -> Span<byte>
Public MustOverride Function GetSpan (Optional sizeHint As Integer = 0) As Span(Of Byte)

Parâmetros

sizeHint
Int32

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

Retornos

Um buffer de, pelo menos, sizeHint bytes.A 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 , mas gera uma se o tamanho do buffer solicitado não estiver disponível.This method never returns , but it throws an if the requested buffer size is not available.

Você precisa solicitar um novo buffer depois de chamar Advance(Int32) 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(Int32) to continue writing more data; you cannot write to a previously acquired buffer.

Aplica-se a