StringReader.ReadToEnd 方法

定义

命名空间:

System.IO

程序集:

netstandard.dll, System.Runtime.dll

Source:

StringReader.cs

从当前位置读取到字符串末尾的所有字符，并将其作为单个字符串返回。

public:
 override System::String ^ ReadToEnd();

public override string ReadToEnd();

override this.ReadToEnd : unit -> string

Public Overrides Function ReadToEnd () As String

返回

String

从当前位置到基础字符串末尾的内容。

例外

OutOfMemoryException

内存不足，无法为返回的字符串分配缓冲区。

ObjectDisposedException

当前读取器已关闭。

示例

该代码示例是 TextReader 类中的一个较大示例的一部分。

static void ReadText(TextReader textReader)
{
    Console.WriteLine("From {0} - {1}",
        textReader.GetType().Name, textReader.ReadToEnd());
}

Shared Sub ReadText(aTextReader As TextReader)
    Console.WriteLine("From {0} - {1}", _
        aTextReader.GetType().Name, aTextReader.ReadToEnd())
End Sub

注解

此方法替代 TextReader.ReadToEnd 该方法。

如果当前方法引发一个 OutOfMemoryException，则基础字符串中的读取器位置由该方法能够读取的字符数进行高级，但已读入内部 ReadToEnd 缓冲区的字符将被丢弃。 由于无法更改读取器在字符串中的位置，因此已读取的字符不可恢复，并且只能通过重新初始化来 StringReader访问。 为了避免这种情况，请使用 Read 该方法并将读取字符存储在预先分配的缓冲区中。

下表列出了其他典型或相关的 I/O 任务的示例。

执行此操作...	请参阅本主题中的示例...
创建文本文件。	如何：将文本写入文件
写入文本文件。	如何：将文本写入文件
从文本文件中读取。	如何：从文件读取文本
将文本追加到文件中。	如何：打开日志文件并将其追加到日志文件 File.AppendText FileInfo.AppendText
获取文件的大小。	FileInfo.Length
获取文件的属性。	File.GetAttributes
设置文件的属性。	File.SetAttributes
确定文件是否存在。	File.Exists
从二进制文件读取。	如何：读取和写入新创建的数据文件
写入二进制文件。	如何：读取和写入新创建的数据文件

另请参阅

• 文件和流输入/输出
• 如何：从文件读取文本
• 如何：将文本写入文件