TextReader.ReadLine 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

TextReader.cs

自文字讀取器讀取一行字元，並將資料以字串傳回。

public:
 virtual System::String ^ ReadLine();

public virtual string? ReadLine ();

abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string

Public Overridable Function ReadLine () As String

傳回

String

讀取器中的下一行；如果已經讀取所有字元，則為 null。

例外狀況

IOException

發生 I/O 錯誤。

OutOfMemoryException

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

ObjectDisposedException

TextReader 已關閉。

ArgumentOutOfRangeException

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

備註

行定義為字元序列，後面接著歸位字元 (0x000d) 、換行字元 (0x000a) 、換行字元後面接著換行字元， Environment.NewLine 或資料流程結束記號。 傳回的字串不包含終止歸位字元或換行字元。 如果已到達輸入資料流程的結尾，則傳回值是 null 。

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

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

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

另請參閱

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