PipeWriter.GetSpan(Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns a Span<T> to write to that is at least the requested size, as specified by the sizeHint parameter.
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)Parameters
- sizeHint
- Int32
The minimum length of the returned Span<T>. If 0, a non-empty buffer of arbitrary size is returned.
Returns
A buffer of at least sizeHint bytes. If sizeHint is 0, returns a non-empty buffer of arbitrary size.
Implements
Exceptions
The requested buffer size is not available.
Remarks
There is no guarantee that successive calls will return the same buffer or the same-sized buffer.
This method never returns Span<T>.Empty, but it throws an OutOfMemoryException if the requested buffer size is not available.
You must request a new buffer after calling Advance(Int32) to continue writing more data; you cannot write to a previously acquired buffer.
