PipeWriter.GetMemory(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 Memory<T> in cui scrivere, con almeno le dimensioni richieste, specificate dal parametro sizeHint.

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)

Parametri

sizeHint

Int32

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

Restituisce

Memory<Byte>

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

Implementazioni

GetMemory(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 Memory<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 per continuare a scrivere dati. Non è possibile scrivere in un buffer acquisito in precedenza.