StringReader.ReadToEnd 方法

定义

命名空间:

System.IO

程序集:

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 类提供的一个更大示例的一部分。

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

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
从二进制文件读取。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入

另请参阅

• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件