Reads a line from the underlying string.
Assembly: mscorlib (in mscorlib.dll)
This method overrides the TextReader.ReadLine method.
A line is defined as a sequence of characters followed by a line feed ("\n"), a carriage return ("\r"), or a carriage return immediately followed by a line feed ("\r\n"). The resulting string does not contain the terminating carriage return and/or line feed. The returned value is Nothing if the end of the underlying string has been reached.
If the current method throws an OutOfMemoryException, the reader's position in the underlying string is advanced by the number of characters the method was able to read, and the characters already read into the internal buffer are discarded. Since the position of the reader in the string cannot be changed, the characters already read are unrecoverable, and can be accessed only by reinitializing the StringReader. To avoid such a situation and produce robust code you should use the Read method and store the read characters in a preallocated buffer.
The following table lists examples of other typical or related I/O tasks.
To do this...
See the example in this topic...
Create a text file.
Write to a text file.
Read from a text file.
Append text to a file.
Get the size of a file.
Get the attributes of a file.
Set the attributes of a file.
Determine if a file exists.
Read from a binary file.
Write to a binary file.
This code example is part of a larger example provided for the StringReader class.
' 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)
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.