PipeWriter.GetMemory(Int32) Methode

Definition

Namespace:

System.IO.Pipelines

Assembly:

System.IO.Pipelines.dll

Paket:

System.IO.Pipelines v8.0.0

Gibt eine Memory<T> zum Schreiben zurück, die mindestens die angeforderte, vom sizeHint-Parameter angegebene Größe aufweist.

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)

Parameter

sizeHint

Int32

Die Mindestlänge des zurückgegebenen Memory<T>-Elements. Wenn 0, wird ein nicht leerer Speicherpuffer beliebiger Größe zurückgegeben.

Gibt zurück

Memory<Byte>

Ein Arbeitsspeicherpuffer von mindestens sizeHint Bytes. Gibt einen nicht leeren Puffer beliebiger Größe zurück, wenn sizeHint 0 (null) ist.

Implementiert

GetMemory(Int32)

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.

Diese Methode gibt nie zurück Memory<T>.Empty, löst jedoch ein aus OutOfMemoryException , 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.