StringReader.ReadBlockAsync 메서드

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

오버로드

ReadBlockAsync(Memory<Char>, CancellationToken)	현재 위치에서 시작하여 입력 문자열의 모든 문자를 비동기적으로 읽고 현재 위치를 입력 문자열의 끝으로 이동합니다.
ReadBlockAsync(Char[], Int32, Int32)	현재 문자열에서 지정된 최대 수의 문자를 비동기적으로 읽어 이 데이터를 지정된 인덱스에서 시작되는 버퍼에 씁니다.

ReadBlockAsync(Memory<Char>, CancellationToken)

Source:

StringReader.cs

현재 위치에서 시작하여 입력 문자열의 모든 문자를 비동기적으로 읽고 현재 위치를 입력 문자열의 끝으로 이동합니다.

public override System.Threading.Tasks.ValueTask<int> ReadBlockAsync (Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Overrides Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

매개 변수

buffer

Memory<Char>

이 메서드가 반환될 경우, 현재의 원본에서 읽은 문자를 포함합니다. 읽은 총 문자 수가 0이면 범위는 수정되지 않은 상태로 유지됩니다.

cancellationToken

CancellationToken

취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반환

ValueTask<Int32>

비동기 읽기 작업을 나타내는 작업입니다. TResult 매개 변수의 값은 버퍼 안으로 읽어 들인 총 문자 수를 포함합니다.

예외

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

ReadBlockAsync(Memory<Char>, CancellationToken) 는 비동기적으로 를 호출 ReadBlock(Span<Char>) 하고, 이 호출은 다시 직접 호출됩니다 Read(Span<Char>) .

ReadBlockAsync(Char[], Int32, Int32)

Source:

StringReader.cs

현재 문자열에서 지정된 최대 수의 문자를 비동기적으로 읽어 이 데이터를 지정된 인덱스에서 시작되는 버퍼에 씁니다.

public:
 override System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);

public override System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);

override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>

Public Overrides Function ReadBlockAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)

매개 변수

buffer

Char[]

이 메서드는 지정된 문자 배열의 값이 index와 (index + count - 1) 사이에서 현재 원본으로부터 읽어온 문자로 교체된 상태로 반환됩니다.

index

Int32

쓰기를 시작할 buffer의 위치입니다.

count

Int32

읽을 최대 문자 수입니다. 지정한 문자 수를 버퍼에 기록하기 전에 문자열의 끝에 도달하면 메서드가 반환됩니다.

반환

Task<Int32>

비동기 읽기 작업을 나타내는 작업입니다. TResult 매개 변수의 값은 버퍼 안으로 읽어들인 총 바이트 수를 포함합니다. 현재 사용할 수 있는 바이트 수가 요청된 수보다 작을 경우 결과 값이 요청된 바이트 수보다 작을 수 있으며 문자열의 끝에 도달한 경우에는 0이 될 수도 있습니다.

예외

ArgumentNullException

buffer은 null입니다.

ArgumentOutOfRangeException

index 또는 count가 음수입니다.

ArgumentException

index 및 count의 합계가 버퍼 길이보다 큽니다.

ObjectDisposedException

문자열 판독기가 삭제된 경우

InvalidOperationException

판독기가 현재 이전 읽기 작업에서 사용 중입니다.

설명

매개 변수에 지정된 count 문자 수를 읽거나 문자열의 끝에 도달할 때까지 작업이 완료되지 않습니다.