TextReader.ReadLineAsync 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

重载

ReadLineAsync()	异步读取一行字符并将数据作为字符串返回。
ReadLineAsync(CancellationToken)	异步读取一行字符并将数据作为字符串返回。

ReadLineAsync()

Source:

TextReader.cs

异步读取一行字符并将数据作为字符串返回。

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();

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>

Public Overridable Function ReadLineAsync () As Task(Of String)

返回

Task<String>

表示异步读取操作的任务。 TResult 参数的值包含来自文本读取器的下一行或为 null（如已读取所有字符）。

例外

ArgumentOutOfRangeException

下一行中的字符数大于 Int32.MaxValue。

ObjectDisposedException

文本读取器已被释放。

InvalidOperationException

以前的读取操作当前正在使用读取器。

注解

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 ReadLineAsync 方法的示例，请参阅 StreamReader.ReadLineAsync 方法。

如果当前 TextReader 表示 由 属性返回 Console.In 的标准输入流，则 ReadLineAsync 该方法将同步执行，而不是异步执行。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 ReadLine()异常。

另请参阅

• ReadLineAsync()
• ReadLineAsync()
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

ReadLineAsync(CancellationToken)

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

要监视取消请求的标记。

返回

ValueTask<String>

表示异步读取操作的值任务。 TResult 参数的值包含来自文本读取器的下一行或为 null（如已读取所有字符）。

例外

ArgumentOutOfRangeException

下一行中的字符数大于 Int32.MaxValue。

ObjectDisposedException

文本读取器已被释放。

InvalidOperationException

以前的读取操作当前正在使用读取器。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 ReadLineAsync(CancellationToken) 方法的示例，请参阅 ReadLineAsync(CancellationToken) 方法。

如果当前 TextReader 表示 由 属性返回 Console.In 的标准输入流，则 ReadLineAsync(CancellationToken) 该方法将同步执行，而不是异步执行。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 ReadLine()异常。