TextReader.ReadToEnd 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

TextReader.cs

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

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

傳回

String

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

例外狀況

IOException

發生 I/O 錯誤。

ObjectDisposedException

TextReader 已關閉。

OutOfMemoryException

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

ArgumentOutOfRangeException

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

備註

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

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

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

另請參閱

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