現在位置から TextReader の末尾まですべての文字を読み取り、1 つの文字列として返します。
Public Overridable Function ReadToEnd() As String
[C#]
public virtual string ReadToEnd();
[C++]
public: virtual String* ReadToEnd();
[JScript]
public function ReadToEnd() : String;
戻り値
現在位置から TextReader の末尾までのすべての文字を含む文字列。
例外
例外の種類 | 条件 |
---|---|
IOException | I/O エラーが発生しました。 |
ObjectDisposedException | TextReader が閉じています。 |
OutOfMemoryException | 返される文字列用のバッファを割り当てるためにはメモリが不足しています。 |
ArgumentOutOfRangeException | 次の行の文字数が、 MaxValue を超えています。 |
解説
現在のメソッドが OutOfMemoryException をスローした場合、基になる Stream 内のリーダーの位置は読み取ることができた文字数分だけ進みますが、既に内部 ReadToEnd バッファに読み取られた文字は破棄されます。ストリーム内のリーダーの位置は変更できないため、既に読み取られた文字は復元できません。もう一度アクセスするには、 TextReader を再初期化する必要があります。ストリーム内での初期位置が不明、またはストリームがシークをサポートしていない場合は、基になる Stream も再初期化する必要があります。
このような状況を回避し、信頼性の高いコードを作成するには、 Read メソッドを使用して、割り当て済みのバッファに読み取った文字を格納する必要があります。
その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。
実行するタスク | 参考例があるトピック |
---|---|
テキスト ファイルを作成する。 | ファイルへのテキストの書き込み |
テキスト ファイルに書き込む。 | ファイルへのテキストの書き込み |
テキスト ファイルから読み取る。 | ファイルからのテキストの読み取り |
テキストをファイルに追加する。 | ログ ファイルのオープンと追加 |
ファイルのサイズを取得する。 | FileInfo.Length |
ファイルの属性を取得する。 | File.GetAttributes |
ファイルの属性を設定する。 | File.SetAttributes |
ファイルが存在するかどうかを判別する。 | File.Exists |
バイナリ ファイルから読み取る。 | 新しく作成したデータ ファイルの読み取りと書き込み |
バイナリ ファイルに書き込む。 | 新しく作成したデータ ファイルの読み取りと書き込み |
使用例
[Visual Basic, C#, C++] 次のコード例は TextReader クラスの例の一部です。
Shared Sub ReadText(aTextReader As TextReader)
Console.WriteLine("From {0} - {1}", _
aTextReader.GetType().Name, aTextReader.ReadToEnd())
End Sub
[C#]
static void ReadText(TextReader textReader)
{
Console.WriteLine("From {0} - {1}",
textReader.GetType().Name, textReader.ReadToEnd());
}
[C++]
static void ReadText(TextReader* textReader)
{
Console::WriteLine(S"From {0} - {1}",
textReader->GetType()->Name, textReader->ReadToEnd());
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
TextReader クラス | TextReader メンバ | System.IO 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み