IBufferWriter<T>.GetMemory(Int32) Metodo

Definizione

Spazio dei nomi:

System.Buffers

Assembly:

System.Memory.dll

Restituisce un elemento Memory<T> in cui scrivere, con almeno le dimensioni richieste (specificate da sizeHint).

public Memory<T> GetMemory (int sizeHint = 0);

abstract member GetMemory : int -> Memory<'T>

Public Function GetMemory (Optional sizeHint As Integer = 0) As Memory(Of T)

Parametri

sizeHint

Int32

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

Restituisce

Memory<T>

Elemento Memory<T> con dimensioni pari almeno a sizeHint. Se sizeHint è 0, restituisce un buffer non vuoto.

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 non deve mai restituire Span<T>.Empty, ma può generare 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.