PipeWriter.GetSpan(Int32) Metoda

Definicja

Przestrzeń nazw:

System.IO.Pipelines

Zestaw:

System.IO.Pipelines.dll

Pakiet:

System.IO.Pipelines v8.0.0

Źródło:

PipeWriter.cs

Zwraca wartość , Span<T> aby zapisać do tego parametru jest co najmniej żądanym rozmiarem sizeHint określonym przez parametr .

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)

Parametry

sizeHint

Int32

Minimalna długość zwróconej Span<T>wartości . Jeśli wartość 0, zwracany jest niepusty bufor dowolnego rozmiaru.

Zwraca

Span<Byte>

Bufor co najmniej sizeHint bajtów. Jeśli sizeHint wartość to 0, zwraca niepusty bufor o dowolnym rozmiarze.

Implementuje

GetSpan(Int32)

Wyjątki

OutOfMemoryException

Żądany rozmiar buforu jest niedostępny.

Uwagi

Nie ma gwarancji, że kolejne wywołania będą zwracać ten sam bufor lub bufor o takim samym rozmiarze.

Ta metoda nigdy nie zwraca Span<T>.Emptywartości , ale zgłasza OutOfMemoryException wartość , jeśli żądany rozmiar buforu jest niedostępny.

Po wywołaniu wywołania Advance(Int32) należy zażądać nowego buforu, aby kontynuować zapisywanie większej ilości danych. Nie można zapisać w wcześniej uzyskanym buforze.