PipeWriter.GetSpan(Int32) Método

Definición

Espacio de nombres:

System.IO.Pipelines

Ensamblado:

System.IO.Pipelines.dll

Paquete:

System.IO.Pipelines v8.0.0

Source:

PipeWriter.cs

Devuelve un objeto Span<T> en el que escribir, que tiene al menos el tamaño solicitado, en función de lo especificado por el parámetro sizeHint.

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

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

Devoluciones

Span<Byte>

Un búfer de al menos sizeHint bytes. Si sizeHint es 0, se devuelve un búfer no vacío de tamaño arbitrario.

Implementaciones

GetSpan(Int32)

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.

Este método nunca devuelve Span<T>.Empty, pero produce un OutOfMemoryException si el tamaño del búfer solicitado no está disponible.

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