共用方式為


TextReader.ReadLineAsync 方法

定義

多載

ReadLineAsync()

非同步讀取一行字元,並將資料以字串傳回。

ReadLineAsync(CancellationToken)

非同步讀取一行字元,並將資料以字串傳回。

ReadLineAsync()

來源:
TextReader.cs
來源:
TextReader.cs
來源:
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

文字讀取器已處置。

之前的讀取作業目前正在使用讀取器。

備註

類別是抽象類別, 因此,您的程式碼中不必將它執行個體化。 如需使用 ReadLineAsync 方法的範例,請參閱 StreamReader.ReadLineAsync 方法。

如果目前 TextReader 代表 屬性傳 Console.In 回的標準輸入數據流,則 ReadLineAsync 方法會以同步方式執行,而不是以異步方式執行。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用狀況例外狀況,例如 ArgumentException,仍會同步擲回。 如需預存的例外狀況,請參閱 所 ReadLine()擲回的例外狀況。

另請參閱

適用於

ReadLineAsync(CancellationToken)

來源:
TextReader.cs
來源:
TextReader.cs
來源:
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

文字讀取器已處置。

之前的讀取作業目前正在使用讀取器。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

類別是抽象類別, 因此,您的程式碼中不必將它執行個體化。 如需使用 ReadLineAsync(CancellationToken) 方法的範例,請參閱 ReadLineAsync(CancellationToken) 方法。

如果目前 TextReader 代表 屬性傳 Console.In 回的標準輸入數據流,則 ReadLineAsync(CancellationToken) 方法會以同步方式執行,而不是以異步方式執行。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用狀況例外狀況,例如 ArgumentException,仍會同步擲回。 如需預存的例外狀況,請參閱 所 ReadLine()擲回的例外狀況。

適用於