PipeWriter.GetSpan(Int32) Metodo

Definizione

Spazio dei nomi:

System.IO.Pipelines

Assembly:

System.IO.Pipelines.dll

Pacchetto:

System.IO.Pipelines v8.0.0

Origine:

PipeWriter.cs

Restituisce un elemento Span<T> in cui scrivere, con almeno le dimensioni richieste, specificate dal parametro 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)

Parametri

sizeHint

Int32

Lunghezza minima dell'elemento Span<T> restituito. Se è 0, viene restituito un buffer non vuoto di dimensioni arbitrarie.

Restituisce

Span<Byte>

Un buffer di almeno sizeHint byte. Se sizeHint è 0, restituisce un buffer non vuoto di dimensioni arbitrarie.

Implementazioni

GetSpan(Int32)

Eccezioni

OutOfMemoryException

Le dimensioni del buffer richieste non sono disponibili.

Commenti

Non esiste alcuna garanzia che le chiamate successive restituiranno lo stesso buffer o lo stesso buffer di dimensioni.

Questo metodo non restituisce Span<T>.Emptymai , ma genera un valore OutOfMemoryException se la dimensione del buffer richiesta non è disponibile.

È necessario richiedere un nuovo buffer dopo la chiamata a Advance(Int32) per continuare a scrivere dati. Non è possibile scrivere in un buffer acquisito in precedenza.