IBufferWriter<T>.GetMemory(Int32) Metoda

Definice

Obor názvů:

System.Buffers

Sestavení:

System.Memory.dll

Memory<T> Vrátí hodnotu pro zápis, do které je alespoň požadovaná velikost (určená parametrem 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)

Parametry

sizeHint

Int32

Minimální délka vráceného souboru Memory<T>. Pokud je 0, vrátí se neprázdná vyrovnávací paměť.

Návraty

Memory<T>

A Memory<T> alespoň velikosti sizeHint. Pokud sizeHint je hodnota 0, vrátí neprázdnou vyrovnávací paměť.

Výjimky

OutOfMemoryException

Požadovaná velikost vyrovnávací paměti není k dispozici.

Poznámky

Neexistuje žádná záruka, že po sobě jdoucí volání vrátí stejnou vyrovnávací paměť nebo vyrovnávací paměť stejné velikosti.

Tato funkce nesmí nikdy vrátit Span<T>.Empty, ale může vyvolat, pokud není k dispozici požadovaná velikost vyrovnávací paměti.

Pokud chcete pokračovat v zápisu dalších dat, musíte po volání Advance požádat o novou vyrovnávací paměť. Do dříve získané vyrovnávací paměti nemůžete zapisovat.