TextReader.ReadLineAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
ReadLineAsync() |
한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다. |
ReadLineAsync(CancellationToken) |
한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다. |
ReadLineAsync()
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다.
public:
virtual System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();
public virtual System.Threading.Tasks.Task<string> ReadLineAsync ();
public virtual System.Threading.Tasks.Task<string?> ReadLineAsync ();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task<string> ReadLineAsync ();
abstract member ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
Public Overridable Function ReadLineAsync () As Task(Of String)
반환
비동기 읽기 작업을 나타내는 작업입니다. TResult
매개 변수의 값은 텍스트 판독기의 다음 줄을 포함하거나 모든 문자가 읽혀진 경우에는 null
입니다.
- 특성
예외
다음 줄의 문자 수가 Int32.MaxValue보다 큽습니다.
텍스트 판독기가 삭제된 경우
판독기가 현재 이전 읽기 작업에서 사용 중입니다.
설명
TextReader 클래스는 추상 클래스입니다. 따라서 코드에서 인스턴스화하지 않습니다. 메서드를 사용하는 예제는 ReadLineAsync 메서드를 참조하세요 StreamReader.ReadLineAsync .
현재 TextReader 가 속성에서 반환된 표준 입력 스트림을 Console.In 나타내는 경우 메서드는 ReadLineAsync 비동기식이 아닌 동기적으로 실행됩니다.
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw ReadLine()된 예외를 참조하세요.
추가 정보
적용 대상
ReadLineAsync(CancellationToken)
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다.
public:
virtual System::Threading::Tasks::ValueTask<System::String ^> ReadLineAsync(System::Threading::CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<string?> ReadLineAsync (System.Threading.CancellationToken cancellationToken);
abstract member ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>
override this.ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>
Public Overridable Function ReadLineAsync (cancellationToken As CancellationToken) As ValueTask(Of String)
매개 변수
- cancellationToken
- CancellationToken
취소 요청을 모니터링할 토큰입니다.
반환
비동기 읽기 작업을 나타내는 값 작업입니다. TResult
매개 변수의 값은 텍스트 판독기의 다음 줄을 포함하거나 모든 문자가 읽혀진 경우에는 null
입니다.
예외
다음 줄의 문자 수가 Int32.MaxValue보다 큽습니다.
텍스트 판독기가 삭제된 경우
판독기가 현재 이전 읽기 작업에서 사용 중입니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
TextReader 클래스는 추상 클래스입니다. 따라서 코드에서 인스턴스화하지 않습니다. 메서드를 사용하는 예제는 ReadLineAsync(CancellationToken) 메서드를 참조하세요 ReadLineAsync(CancellationToken) .
현재 TextReader 가 속성에서 반환된 표준 입력 스트림을 Console.In
나타내는 경우 메서드는 ReadLineAsync(CancellationToken) 비동기식이 아닌 동기적으로 실행됩니다.
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw ReadLine()된 예외를 참조하세요.
적용 대상
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기