System.IO.StringReader.ReadLine 方法
方法描述
从基础字符串中读取一行。
语法定义(C# System.IO.StringReader.ReadLine 方法 的用法)
public override string ReadLine()
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| 返回值 | System.String | 基础字符串中的下一行；或者如果到达了基础字符串的末尾，则为 null。 |
提示和注释
此方法重写 TextReader.ReadLine 方法。
将行定义为后面跟有下列符号的字符序列：换行符（“\n”）、回车符（“\r”）或后跟换行符的回车符（“\r\n”）。 所产生的字符串不包含终止回车符和/或换行符。 如果已到达基础字符串的结尾，则返回值为 null。
如果当前方法引发 OutOfMemoryException，则读取器在基础字符串中的位置将会向前推进此方法能够读取的字符数，而已经读入内部 ReadLine 缓冲区中的字符将被放弃。 因为无法更改读取器在字符串中的位置，所以已经读取的字符是无法恢复的，只能通过重新初始化 StringReader 访问它们。 为避免这种情况并产生可靠的代码，应使用 Read 方法，并将已读取的字符存储在预先分配的缓冲区内。
下表列出了其他典型或相关的 I/O 任务的示例。
若要执行此操作...
请参见本主题中的示例...
创建文本文件。
如何：向文件写入文本
写入文本文件。
如何：向文件写入文本
读取文本文件。
如何：从文件读取文本
向文件中追加文本。
如何：打开并追加到日志文件
File.AppendText
FileInfo.AppendText
获取文件大小。
FileInfo.Length
获取文件特性。
File.GetAttributes
设置文件特性。
File.SetAttributes
确定文件是否存在。
File.Exists
读取二进制文件。
如何：对新建的数据文件进行读取和写入
写入二进制文件。
如何：对新建的数据文件进行读取和写入
System.IO.StringReader.ReadLine 方法例子
此代码示例摘自一个为 StringReader 类提供的更大示例。
// 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);
异常
| 异常 | 异常描述 |
|---|---|
| ObjectDisposedException | 当前读取器已关闭。 |
| OutOfMemoryException | 内存不足，无法为返回的字符串分配缓冲区。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1 受以下版本支持：
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。