IBufferWriter<T>.GetMemory(Int32) Methode

Definition

Namespace:

System.Buffers

Assembly:

System.Memory.dll

Gibt ein Memory<T>-Element zum Zurückschreiben zurück, das mindestens die angeforderte (von sizeHint angegebene) Größe aufweist.

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)

Parameter

sizeHint

Int32

Die Mindestlänge des zurückgegebenen Memory<T>-Elements. Wenn dieser Wert 0 lautet, wird ein nicht leerer Puffer zurückgegeben.

Gibt zurück

Memory<T>

Ein Memory<T>-Element, dessen Größe mindestens sizeHint beträgt. Gibt einen nicht leeren Puffer zurück, wenn sizeHint 0 ist.

Ausnahmen

OutOfMemoryException

Die angeforderte Puffergröße ist nicht verfügbar.

Hinweise

Es gibt keine Garantie dafür, dass aufeinanderfolgende Aufrufe denselben Puffer oder den Puffer der gleichen Größe zurückgeben.

Dies darf niemals zurückgegeben Span<T>.Emptywerden, kann jedoch ausgelöst werden, wenn die angeforderte Puffergröße nicht verfügbar ist.

Sie müssen nach dem Aufruf von Advance einen neuen Puffer anfordern, um weitere Daten zu schreiben; Sie können nicht in einen zuvor abgerufenen Puffer schreiben.