TextReader.ReadLine TextReader.ReadLine TextReader.ReadLine TextReader.ReadLine Method

定義

テキスト リーダーから 1 行分の文字を読み取り、そのデータを文字列として返します。Reads a line of characters from the text reader and returns the data as a string.

public:
 virtual System::String ^ ReadLine();
public virtual string ReadLine ();
abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string
Public Overridable Function ReadLine () As String

戻り値

リーダーの次の行。またはすべての文字が読み取られた場合は nullThe next line from the reader, or null if all characters have been read.

例外

I/O エラーが発生します。An I/O error occurs.

返却された文字列にバッファーを割り当てるには、メモリが不足しています。There is insufficient memory to allocate a buffer for the returned string.

次の行の文字数が、MaxValue を超えています。The number of characters in the next line is larger than MaxValue

注釈

行は、一連の文字として定義され、その後に復帰 (0x000d)、改行 (0x000d)、キャリッジリターンの後にラインフィード、 Environment.NewLine、またはストリームの末尾マーカーとして定義されます。A line is defined as a sequence of characters followed by a carriage return (0x000d), a line feed (0x000a), a carriage return followed by a line feed, Environment.NewLine, or the end-of-stream marker. 返される文字列には、終端の復帰またはラインフィードは含まれません。The string that is returned does not contain the terminating carriage return or line feed. 入力ストリームの末尾nullに到達した場合、戻り値はになります。The return value is null if the end of the input stream has been reached.

メソッドがOutOfMemoryException例外をスローした場合、基になるStreamのリーダーの位置は、メソッドが読み取ることができた文字数だけ進んでいますが、既に内部ReadLineバッファーに読み込まれていた文字は、あっ.If the method throws an OutOfMemoryException exception, the reader's position in the underlying Stream is advanced by the number of characters the method was able to read, but the characters that were already read into the internal ReadLine buffer are discarded. ストリーム内のリーダーの位置は変更できないため、既に読み取られた文字は回復不能であり、オブジェクトをTextReader再初期化することによってのみアクセスできます。Because the position of the reader in the stream cannot be changed, the characters that were already read are unrecoverable and can be accessed only by reinitializing the TextReader object. ストリーム内の最初の位置が不明な場合、またはストリームがシークをサポートしStreamていない場合は、基になるも再初期化する必要があります。If the initial position within the stream is unknown or the stream does not support seeking, the underlying Stream also needs to be reinitialized.

このような状況を回避し、堅牢なコードを生成Readするには、メソッドを使用して、事前に割り当てられたバッファーに読み取り文字を格納する必要があります。To avoid such a situation and produce robust code you should use the Read method and store the read characters in a preallocated buffer.

TextReader クラスは抽象クラスです。The TextReader class is an abstract class. そのため、コードでそれをインスタンス化することはありません。Therefore, you do not instantiate it in your code. ReadLineメソッドの使用例については、 StreamReader.ReadLineメソッドを参照してください。For an example of using the ReadLine method, see the StreamReader.ReadLine method.

適用対象

こちらもご覧ください