TextReader.ReadToEndAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

ReadToEndAsync()	非同步讀取從目前位置到文字讀取器末端的所有字元，並將它們以單一字串傳回。
ReadToEndAsync(CancellationToken)	非同步讀取從目前位置到文字讀取器末端的所有字元，並將它們以單一字串傳回。

ReadToEndAsync()

來源:

TextReader.cs

非同步讀取從目前位置到文字讀取器末端的所有字元，並將它們以單一字串傳回。

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

public virtual System.Threading.Tasks.Task<string> ReadToEndAsync ();

abstract member ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>

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

傳回

Task<String>

表示非同步讀取作業的工作。 TResult 參數的值會包含字串，該字串含有從目前位置到文字讀取器結尾的字元。

例外狀況

ArgumentOutOfRangeException

字元數大於 Int32.MaxValue。

ObjectDisposedException

文字讀取器已處置。

InvalidOperationException

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

備註

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

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

另請參閱

• ReadToEndAsync()
• ReadToEndAsync()
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

ReadToEndAsync(CancellationToken)

來源:

TextReader.cs

非同步讀取從目前位置到文字讀取器末端的所有字元，並將它們以單一字串傳回。

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<string> ReadToEndAsync (System.Threading.CancellationToken cancellationToken);

abstract member ReadToEndAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
override this.ReadToEndAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Overridable Function ReadToEndAsync (cancellationToken As CancellationToken) As Task(Of String)

參數

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。

傳回

Task<String>

表示非同步讀取作業的工作。 TResult 參數的值會包含字串，該字串含有從目前位置到文字讀取器結尾的字元。

例外狀況

ArgumentOutOfRangeException

字元數大於 Int32.MaxValue。

ObjectDisposedException

文字讀取器已處置。

InvalidOperationException

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

OperationCanceledException

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

備註

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

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