PipeWriter.GetMemory(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ść , Memory<T> aby zapisać do tego parametru jest co najmniej żądanym rozmiarem sizeHint określonym przez parametr .

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)

Parametry

sizeHint

Int32

Minimalna długość zwróconej Memory<T>wartości . Jeśli wartość 0, zwracany jest niepusty bufor pamięci o dowolnym rozmiarze.

Zwraca

Memory<Byte>

Bufor pamięci o co najmniej sizeHint bajtach. Jeśli sizeHint wartość to 0, zwraca niepusty bufor o dowolnym rozmiarze.

Implementuje

GetMemory(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 Memory<T>.Emptywartości , ale zgłasza OutOfMemoryException wartość , jeśli żądany rozmiar buforu jest niedostępny.

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