PipeWriter.GetSpan(Int32) 메서드

정의

sizeHint 매개 변수를 통해 지정된 요청된 크기 이상으로 기록할 Span<T>을 반환합니다.

public abstract Span<byte> GetSpan (int sizeHint = 0);

매개 변수

sizeHint
Int32

반환되는 Span<T>의 최소 길이입니다. 0인 경우 비어 있지 않은 임의의 크기의 버퍼가 반환됩니다.

반환

sizeHint 바이트 이상의 버퍼입니다. sizeHint가 0인 경우 비어 있지 않은 임의의 크기의 버퍼를 반환합니다.

구현

예외

요청된 버퍼 크기를 사용할 수 없습니다.

설명

연속 호출이 동일한 버퍼 또는 동일한 크기의 버퍼를 반환한다는 보장은 없습니다.

이 메서드는 를 반환 Span<T>.Empty하지 않지만 요청된 OutOfMemoryException 버퍼 크기를 사용할 수 없는 경우 을 throw합니다.

Advance(Int32)를 호출한 후 새 버퍼를 요청하여 더 많은 데이터를 계속 써야 합니다. 이전에 가져온 버퍼에는 쓸 수 없습니다.

적용 대상