StringReader.ReadAsync 메서드

정의

네임스페이스:
System.IO
어셈블리:
netstandard.dll
어셈블리:
mscorlib.dll, System.IO.dll
어셈블리:
mscorlib.dll
어셈블리:
System.IO.dll

오버로드

Name Description
ReadAsync(Memory<Char>, CancellationToken)

현재 위치에서 시작하여 입력 문자열의 모든 문자를 비동기적으로 읽고 현재 위치를 입력 문자열의 끝으로 진행합니다.
ReadAsync(Char[], Int32, Int32)

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

ReadAsync(Memory<Char>, CancellationToken)

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

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

매개 변수

buffer
Memory<Char>

이 메서드가 반환되면 현재 소스에서 읽은 문자가 포함됩니다.

cancellationToken
CancellationToken

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

반품

ValueTask<Int32>

비동기 읽기 작업을 나타내는 작업입니다. 매개 변수 값 TResult 에는 버퍼로 읽은 총 문자 수가 포함됩니다.

예외

OperationCanceledException

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

적용 대상

ReadAsync(Char[], Int32, Int32)

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

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

매개 변수

buffer
Char[]

이 메서드가 반환될 때 현재 소스에서 읽은 문자로 바뀐 값과 (index + count- 1) 사이의 index 값을 가진 지정된 문자 배열을 포함합니다.

index
Int32

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

count
Int32

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

반품

Task<Int32>

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

특성
ComVisibleAttribute

예외

ArgumentNullException

buffer은 null입니다.

ArgumentOutOfRangeException

index 또는 count 음수입니다.

ArgumentException

버퍼 길이보다 큰 합계 index 입니다 count .

ObjectDisposedException

문자열 판독기를 삭제했습니다.

InvalidOperationException

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

예제

다음 예제에서는 문자열의 처음 23자를 비동기적으로 읽는 방법을 보여줍니다.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            string stringToRead = "Some characters to read but not all";
            char[] charsRead = new char[stringToRead.Length];

            using (StringReader reader = new StringReader(stringToRead))
            {
                await reader.ReadAsync(charsRead, 0, 23);
                Console.WriteLine(charsRead);
            }
        }
    }
}
// The example displays the following output:
// Some characters to read
//

Imports System.IO

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = "Some characters to read but not all"
        Dim charsRead(stringToRead.Length) As Char

        Using reader As StringReader = New StringReader(stringToRead)
            Await reader.ReadAsync(charsRead, 0, 23)
            Console.WriteLine(charsRead)
        End Using
    End Sub

End Module
' The example displays the following output:
' Some characters to read
'

설명

매개 변수에 지정된 count 문자 수를 읽거나 문자열 끝에 도달하면 작업이 완료됩니다.

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Read(Char[], Int32, Int32)throw된 예외를 참조하세요.

적용 대상