PipeWriter.GetSpan(Int32) Methode

Definition

Namespace:

System.IO.Pipelines

Assembly:

System.IO.Pipelines.dll

Paket:

System.IO.Pipelines v8.0.0

Quelle:

PipeWriter.cs

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

Span<Byte>

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

Implementiert

GetSpan(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 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.