基になる文字列から 1 行読み取ります。
Overrides Public Function ReadLine() As String
[C#]
public override string ReadLine();
[C++]
public: String* ReadLine();
[JScript]
public override function ReadLine() : String;
戻り値
基になる文字列の次の行。基になる文字列の末尾に到達した場合は null 参照 (Visual Basic では Nothing) 。
例外
例外の種類 | 条件 |
---|---|
ObjectDisposedException | 現在のリーダーが閉じています。 |
OutOfMemoryException | 返される文字列用のバッファを割り当てるためにはメモリが不足しています。 |
解説
このメソッドは、 TextReader.ReadLine メソッドをオーバーライドします。
行は、キャリッジ リターン ("\r")、ライン フィード ("\n")、またはキャリッジ リターンとライン フィードの組み合わせが末尾に付いた一連の文字として定義されます。しかし、返される文字列には、行の終端を示すキャリッジ リターンやライン フィードは含まれません。基になる文字列の末尾に到達している場合、戻り値は null 参照 (Visual Basic では Nothing) になります。
現在のメソッドが OutOfMemoryException をスローした場合、基になる文字列内のリーダーの位置は読み取ることができた文字数分だけ進みますが、既に内部 ReadLine バッファに読み取られた文字は破棄されます。文字列内のリーダーの位置は変更できないため、既に読み取られた文字は復元できません。もう一度アクセスするには、 StringReader を再初期化する必要があります。このような状況を回避し、信頼性の高いコードを作成するには、 Read メソッドを使用して、割り当て済みのバッファに読み取った文字を格納する必要があります。
その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。
実行するタスク | 参考例があるトピック |
---|---|
テキスト ファイルを作成する。 | ファイルへのテキストの書き込み |
テキスト ファイルに書き込む。 | ファイルへのテキストの書き込み |
テキスト ファイルから読み取る。 | ファイルからのテキストの読み取り |
テキストをファイルに追加する。 | ログ ファイルのオープンと追加 |
ファイルのサイズを取得する。 | FileInfo.Length |
ファイルの属性を取得する。 | File.GetAttributes |
ファイルの属性を設定する。 | File.SetAttributes |
ファイルが存在するかどうかを判別する。 | File.Exists |
バイナリ ファイルから読み取る。 | 新しく作成したデータ ファイルの読み取りと書き込み |
バイナリ ファイルに書き込む。 | 新しく作成したデータ ファイルの読み取りと書き込み |
使用例
[Visual Basic, C#, C++] 次のコード例は StringReader クラスの例の一部です。
' From textReaderText, create a continuous paragraph
' with two spaces between each sentence.
Dim aLine, aParagraph As String
Dim strReader As New StringReader(textReaderText)
While True
aLine = strReader.ReadLine()
If aLine Is Nothing Then
aParagraph = aParagraph & vbCrLf
Exit While
Else
aParagraph = aParagraph & aLine & " "
End If
End While
Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _
aParagraph)
[C#]
// From textReaderText, create a continuous paragraph
// with two spaces between each sentence.
string aLine, aParagraph = null;
StringReader strReader = new StringReader(textReaderText);
while(true)
{
aLine = strReader.ReadLine();
if(aLine != null)
{
aParagraph = aParagraph + aLine + " ";
}
else
{
aParagraph = aParagraph + "\n";
break;
}
}
Console.WriteLine("Modified text:\n\n{0}", aParagraph);
[C++]
// From textReaderText, create a continuous paragraph
// with two spaces between each sentence.
String* aLine, * aParagraph;
StringReader* strReader = new StringReader(textReaderText);
while(true)
{
aLine = strReader->ReadLine();
if(aLine != 0)
{
aParagraph =
String::Concat(aParagraph, aLine, " ");
}
else
{
aParagraph = String::Concat(aParagraph, "\n");
break;
}
}
Console::WriteLine("Modified text:\n\n{0}", aParagraph);
[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
参照
StringReader クラス | StringReader メンバ | System.IO 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み