TextReader.ReadLine メソッド

[アーティクル]
03/28/2008

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

Public Overridable Function ReadLine() As String
[C#]
public virtual string ReadLine();
[C++]
public: virtual String* ReadLine();
[JScript]
public function ReadLine() : String;

戻り値

入力ストリームの次の行。またはすべての文字が読み取られた場合は null 参照 (Visual Basic では Nothing) 。

例外

例外の種類	条件
IOException	I/O エラーが発生しました。
OutOfMemoryException	返される文字列用のバッファを割り当てるためにはメモリが不足しています。
ObjectDisposedException	TextReader が閉じています。
ArgumentOutOfRangeException	次の行の文字数が、 MaxValue を超えています。

解説

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

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

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

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	ファイルへのテキストの書き込み
テキストファイルに書き込む。	ファイルへのテキストの書き込み
テキストファイルから読み取る。	ファイルからのテキストの読み取り
テキストをファイルに追加する。	ログファイルのオープンと追加 File.AppendText FileInfo.AppendText
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	新しく作成したデータファイルの読み取りと書き込み
バイナリファイルに書き込む。	新しく作成したデータファイルの読み取りと書き込み

必要条件

プラットフォーム: 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.ReadLine メソッド

戻り値

例外

解説

必要条件

参照

その他のリソース