TextReader.ReadToEnd 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
讀取從目前位置到文字讀取器末端的所有字元,並將它們以單一字串傳回。
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 方法。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應