StreamReader.ReadLine メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

StreamReader.cs

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

C#

public override string? ReadLine ();

戻り値

String

入力ストリームからの次の行。入力ストリームの末尾に到達した場合は null。

例外

OutOfMemoryException

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

IOException

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

例

次のコード例では、ファイルの末尾に達するまでファイルから行を読み取ります。

C#

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path))
            {
                while (sr.Peek() >= 0)
                {
                    Console.WriteLine(sr.ReadLine());
                }
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

注釈

行は、一連の文字の後に改行 ("\n")、復帰 ("\r")、またはキャリッジ リターンの直後に改行 ("\r\n") として定義されます。 返される文字列には、終了復帰または改行は含まれません。 返される値は、 null 入力ストリームの末尾に達した場合です。

このメソッドは、TextReader.ReadLine をオーバーライドします。

現在のメソッドが を OutOfMemoryExceptionスローする場合、基になる Stream オブジェクト内のリーダーの位置は、メソッドが読み取ることができる文字数だけ進みますが、内部 ReadLine バッファーに既に読み込まれている文字は破棄されます。 バッファーへのデータの読み取り後に基になるストリームの位置を操作すると、基になるストリームの位置が内部バッファーの位置と一致しない可能性があります。 内部バッファーをリセットするには、 メソッドを DiscardBufferedData 呼び出します。ただし、このメソッドはパフォーマンスを低下させ、絶対に必要な場合にのみ呼び出す必要があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

適用対象

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み