TextReader.ReadLineAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

ReadLineAsync()	非同步讀取一行字元，並將資料以字串傳回。
ReadLineAsync(CancellationToken)	非同步讀取一行字元，並將資料以字串傳回。

ReadLineAsync()

來源:

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)

來源:

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() 擲回的例外狀況。