Windows apps
Collapse the table of content
Expand the table of content

TextReader Class

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Represents a reader that can read a sequential series of characters.

Namespace:  System.IO
Assembly:  System.IO (in System.IO.dll)

[SerializableAttribute]
public abstract class TextReader : MarshalByRefObject, 
	IDisposable

The TextReader type exposes the following members.

  NameDescription
Protected methodTextReaderInitializes a new instance of the TextReader class.
Top

  NameDescription
Public methodCloseCloses the TextReader and releases any system resources associated with the TextReader.
Public methodDispose()()()()Releases all resources used by the TextReader object.
Protected methodDispose(Boolean)Releases the unmanaged resources used by the TextReader and optionally releases the managed resources.
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodPeekReads the next character without changing the state of the reader or the character source. Returns the next available character without actually reading it from the reader.
Public methodRead()()()()Reads the next character from the text reader and advances the character position by one character.
Public methodRead(array<Char>[]()[][], Int32, Int32)Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.
Public methodReadBlockReads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.
Public methodReadLineReads a line of characters from the text reader and returns the data as a string.
Public methodReadToEndReads all characters from the current position to the end of the text reader and returns them as one string.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

TextReader is the abstract base class of StreamReader and StringReader, which read characters from streams and strings, respectively. Use these derived classes to open a text file for reading a specified range of characters, or to create a reader based on an existing stream.

Notes to Inheritors

A derived class must minimally implement the Peek and Read methods to make a useful instance of TextReader.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2017 Microsoft