共用方式為


TextReader.ReadLine 方法

定義

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

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

傳回

讀取器中的下一行;如果已經讀取所有字元,則為 null

例外狀況

發生 I/O 錯誤。

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

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

備註

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

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

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

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

適用於

另請參閱