情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

TextReader.ReadLine メソッド

2013/12/12

現在のストリームから 1 行分の文字を読み取り、そのデータを文字列として返します。

Namespace:  System.IO
アセンブリ:  mscorlib (mscorlib.dll 内)

public virtual string ReadLine()

戻り値

型: System.String
入力ストリームの次の行。すべての文字が読み取られた場合は null

例外条件
IOException

I/O エラーが発生しました。

OutOfMemoryException

返される文字列用のバッファーを割り当てるにはメモリが不足しています。

ObjectDisposedException

TextReader が閉じています。

ArgumentOutOfRangeException

次の行の文字数が、MaxValue を超えています。

行は、復帰 (0x000d)、ライン フィード (0x000a)、復帰とライン フィードの組み合わせ、Environment.NewLine、またはストリームの終わりを示すマーカーが後に付いた文字シーケンスとして定義されています。しかし、返される文字列には、行の終端を示すキャリッジ リターンやライン フィードは含まれません。入力ストリームの末尾に達している場合、戻り値は null になります。

現在のメソッドが OutOfMemoryException をスローした場合、基になる Stream 内のリーダーの位置は読み取ることができた文字数分だけ進みますが、既に内部 ReadLine バッファーに読み取られた文字は破棄されます。ストリーム内のリーダーの位置は変更できないため、既に読み取られた文字は復元できません。もう一度アクセスするには、TextReader を再初期化する必要があります。ストリーム内の初期位置が不明であるか、ストリームがシークをサポートしない場合は、基になる Stream も再初期化する必要があります。

このような状況を回避し、信頼性の高いコードを作成するには、Read メソッドを使用して、割り当て済みのバッファーに読み取った文字を格納する必要があります。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: