Freigeben über


PipeWriter.GetSpan(Int32) Methode

Definition

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

public abstract Span<byte> GetSpan (int sizeHint = 0);
abstract member GetSpan : int -> Span<byte>
Public MustOverride Function GetSpan (Optional sizeHint As Integer = 0) As Span(Of Byte)

Parameter

sizeHint
Int32

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

Gibt zurück

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

Implementiert

Ausnahmen

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 Span<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(Int32) einen neuen Puffer anfordern, um weitere Daten zu schreiben; Sie können nicht in einen zuvor abgerufenen Puffer schreiben.

Gilt für: