StringReader.ReadToEnd 方法

定義

命名空間:

System.IO

組件:

mscorlib.dll

讀取從當前位置到字串末尾的所有字元，並以單一字串形式返回。

public:
 override System::String ^ ReadToEnd();

public override string ReadToEnd();

override this.ReadToEnd : unit -> string

Public Overrides Function ReadToEnd () As String

傳回

String

從當前位置到底層字串末端的內容。

例外狀況

OutOfMemoryException

記憶體不足以為回傳字串分配緩衝區。

ObjectDisposedException

目前的閱讀器已關閉。

範例

此程式碼範例是本類別更大範例 TextReader 的一部分。

static void ReadText(TextReader textReader)
{
    Console.WriteLine("From {0} - {1}",
        textReader.GetType().Name, textReader.ReadToEnd());
}

Shared Sub ReadText(aTextReader As TextReader)
    Console.WriteLine("From {0} - {1}", _
        aTextReader.GetType().Name, aTextReader.ReadToEnd())
End Sub

備註

此方法會覆蓋該方法。TextReader.ReadToEnd

如果目前的方法拋出 ， OutOfMemoryException讀取器在底層字串中的位置會依該方法能讀取的字元數前進，但已讀入內部 ReadToEnd 緩衝區的字元會被丟棄。 由於讀取器在字串中的位置無法更改，已讀取的字元無法恢復，只能透過重新初始化 來 StringReader存取。 為避免這種情況，請使用該 Read 方法並將讀取字元儲存在預置的緩衝區中。

下表列出其他典型或相關的 I/O 任務範例。

若要這麼做...	請參閱本主題中的範例...
建立文字檔。	如何：將文字寫入檔案
寫入文字檔。	如何：將文字寫入檔案
從文字檔讀取。	如何：從檔案讀取文字
在檔案中附加文字。	如何：開啟並附加至記錄檔 File.AppendText FileInfo.AppendText
拿出檔案大小。	FileInfo.Length
取得檔案的屬性。	File.GetAttributes
設定檔案的屬性。	File.SetAttributes
判斷是否有檔案存在。	File.Exists
從二進位檔案讀取。	如何：讀取和寫入新建立的數據檔
寫入二進位檔案。	如何：讀取和寫入新建立的數據檔

另請參閱

• 檔案和數據流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案