StringReader.ReadToEnd 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

StringReader.cs

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

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

public override string ReadToEnd ();

override this.ReadToEnd : unit -> string

Public Overrides Function ReadToEnd () As String

傳回

String

基礎字串從目前位置至結尾的內容。

例外狀況

OutOfMemoryException

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

ObjectDisposedException

目前的讀取器已關閉。

範例

此程式代碼範例是針對 類別提供的較大範例的 TextReader 一部分。

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

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
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案