共用方式為


TextReader.ReadToEnd 方法

定義

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

public:
 virtual System::String ^ ReadToEnd();
public virtual string ReadToEnd ();
abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> string
Public Overridable Function ReadToEnd () As String

傳回

字串,包含從目前位置到文字讀取器結尾的所有字元。

例外狀況

發生 I/O 錯誤。

沒有足夠記憶體可為傳回的字串配置緩衝區。

下一行中的字元數大於 Int32.MaxValue

備註

如果方法擲回 OutOfMemoryException 例外狀況,則基礎中的 Stream 讀取器位置會由方法能夠讀取的字元數進階,但已讀取內部 ReadToEnd 緩衝區的字元會被捨棄。 因為無法變更數據流中讀取器的位置,所以已經讀取的字元無法復原,而且只能藉由重新初始化 TextReader來存取。 如果數據流內的初始位置不明,或數據流不支持搜尋,則基礎 Stream 也必須重新初始化。

若要避免這種情況並產生強固的程式代碼,您應該使用 Read 方法,並將讀取字元儲存在預先配置的緩衝區中。

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

適用於

另請參閱