StringReader.ReadToEnd 方法

定義

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

public:
 override System::String ^ ReadToEnd();
public override string ReadToEnd ();
override this.ReadToEnd : unit -> string
Public Overrides Function ReadToEnd () As String

傳回

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

例外狀況

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

目前的讀取器已關閉。

範例

此程式代碼範例是針對 類別提供的較大範例的 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
從二進位檔讀取。 作法:讀取和寫入新建立的資料檔案
寫入二進位檔。 作法:讀取和寫入新建立的資料檔案

適用於

另請參閱