TextReader.ReadBlockAsync 메서드

정의

오버로드

ReadBlockAsync(Memory<Char>, CancellationToken)

현재의 스트림에서 비동기적으로 문자를 읽고, 버퍼에 데이터를 씁니다.Asynchronously reads the characters from the current stream and writes the data to a buffer.

ReadBlockAsync(Char[], Int32, Int32)

현재 텍스트 판독기에서 지정된 최대 문자 수를 비동기적으로 읽어 이 데이터를 지정된 위치에서 시작되는 버퍼에 씁니다.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

ReadBlockAsync(Memory<Char>, CancellationToken)

현재의 스트림에서 비동기적으로 문자를 읽고, 버퍼에 데이터를 씁니다.Asynchronously reads the characters from the current stream and writes the data to a buffer.

public virtual System.Threading.Tasks.ValueTask<int> ReadBlockAsync (Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);
abstract member ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overridable Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

매개 변수

buffer
Memory<Char>

이 메서드가 반환될 경우, 현재의 소스에서 읽은 문자로 대체된 문자의 지정된 메모리 블록을 포함합니다.When this method returns, contains the specified memory block of characters replaced by the characters read from the current source.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다.The token to monitor for cancellation requests. 기본값은 None입니다.The default value is None.

반환

ValueTask<Int32>

비동기 읽기 작업을 나타내는 값 작업입니다.A value task that represents the asynchronous read operation. 형식 매개 변수의 값은 버퍼에서 읽어 들인 총 문자 수를 포함합니다.The value of the type parameter contains the total number of characters read into the buffer. 현재 사용할 수 있는 문자 수가 요청된 수보다 작을 경우 결과 값이 요청된 문자 수보다 작을 수 있으며, 스트림의 끝에 도달한 경우에는 0이 될 수도 있습니다.The result value can be less than the number of characters requested if the number of characters currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached.

적용 대상

ReadBlockAsync(Char[], Int32, Int32)

현재 텍스트 판독기에서 지정된 최대 문자 수를 비동기적으로 읽어 이 데이터를 지정된 위치에서 시작되는 버퍼에 씁니다.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

public:
 virtual System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);
abstract member ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
Public Overridable Function ReadBlockAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)

매개 변수

buffer
Char[]

이 메서드는 지정된 문자 배열의 값이 index와 (index + count - 1) 사이에서 현재 원본으로부터 읽어온 문자로 교체된 상태로 반환됩니다.When this method returns, contains the specified character array with the values between index and (index + count - 1) replaced by the characters read from the current source.

index
Int32

쓰기를 시작할 buffer의 위치입니다.The position in buffer at which to begin writing.

count
Int32

읽을 최대 문자 수입니다.The maximum number of characters to read. 지정한 문자 수를 버퍼로 읽어오기 전에 텍스트의 끝에 도달하면 현재 메서드가 반환됩니다.If the end of the text is reached before the specified number of characters is read into the buffer, the current method returns.

반환

Task<Int32>

비동기 읽기 작업을 나타내는 작업입니다.A task that represents the asynchronous read operation. TResult 매개 변수의 값은 버퍼 안으로 읽어들인 총 바이트 수를 포함합니다.The value of the TResult parameter contains the total number of bytes read into the buffer. 현재 사용할 수 있는 바이트 수가 요청된 수보다 작을 경우 결과 값이 요청된 바이트 수보다 작을 수 있으며 텍스트의 끝에 도달한 경우에는 0이 될 수도 있습니다.The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the text has been reached.

특성

예외

buffer이(가) null인 경우buffer is null.

index 또는 count가 음수입니다.index or count is negative.

indexcount의 합계가 버퍼 길이보다 큽니다.The sum of index and count is larger than the buffer length.

텍스트 판독기가 삭제된 경우The text reader has been disposed.

판독기가 현재 이전 읽기 작업에서 사용 중입니다.The reader is currently in use by a previous read operation.

설명

매개 변수에 지정 된 문자 수를 읽을 때까지 count 또는 텍스트의 끝에 도달 하기 전 까지는 태스크가 완료 되지 않습니다.The task does not complete until either the number of characters specified by the count parameter are read, or the end of the text has been reached.

추가 정보

적용 대상