Early Preview
This is currently very much a preview. Please feel free to try things out,
but don't be upset if anything is not yet working. Feedback is welcome over on our
GitHub Dicussions page.
class System.IO.TextReader
Assembly: System.Runtime
Inheritance: object → MarshalByRefObject → TextReader
Represents a reader that can read a sequential series of characters.
Fields and Constants
public static readonly
TextReader
Null
Provides a <see langword="TextReader" /> with no data to read from.
Methods
public
void
Close()
Closes the <see cref="T:System.IO.TextReader" /> and releases any system resources associated with the <see langword="TextReader" /> .
public
void
Dispose()
Releases all resources used by the <see cref="T:System.IO.TextReader" /> object.
protected
void
Dispose(bool disposing)
disposing
<see langword="true" /> to release both managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.
Releases the unmanaged resources used by the <see cref="T:System.IO.TextReader" /> and optionally releases the managed resources.
public
int
Peek() Returns An integer representing the next character to be read, or -1 if no more characters are available or the reader does not support seeking.
Reads 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
int
Read() Returns The next character from the text reader, or -1 if no more characters are available. The default implementation returns -1.
Reads the next character from the text reader and advances the character position by one character.
public
int
Read(char[] buffer,
int index,
int count)
buffer
When this method returns, contains the specified character array with the values between <paramref name="index" /> and ( <paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.
index
The position in <paramref name="buffer" /> at which to begin writing.
count
The maximum number of characters to read. If the end of the reader is reached before the specified number of characters is read into the buffer, the method returns.
Returns The number of characters that have been read. The number will be less than or equal to <paramref name="count" /> , depending on whether the data is available within the reader. This method returns 0 (zero) if it is called when no more characters are left to read.
Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.
public
Threading.Tasks.Task`1
ReadAsync(char[] buffer,
int index,
int count)
buffer
When this method returns, contains the specified character array with the values between <paramref name="index" /> and ( <paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.
index
The position in <paramref name="buffer" /> at which to begin writing.
count
The maximum number of characters to read. If the end of the text is reached before the specified number of characters is read into the buffer, the current method returns.
Returns A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the text has been reached.
Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.
public
int
ReadBlock(char[] buffer,
int index,
int count)
buffer
When this method returns, this parameter contains the specified character array with the values between <paramref name="index" /> and ( <paramref name="index" /> + <paramref name="count" /> -1) replaced by the characters read from the current source.
index
The position in <paramref name="buffer" /> at which to begin writing.
count
The maximum number of characters to read.
Returns The number of characters that have been read. The number will be less than or equal to <paramref name="count" /> , depending on whether all input characters have been read.
Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.
public
Threading.Tasks.Task`1
ReadBlockAsync(char[] buffer,
int index,
int count)
buffer
When this method returns, contains the specified character array with the values between <paramref name="index" /> and ( <paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.
index
The position in <paramref name="buffer" /> at which to begin writing.
count
The maximum number of characters to read. If the end of the text is reached before the specified number of characters is read into the buffer, the current method returns.
Returns A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the text has been reached.
Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.
public
string
ReadLine() Returns The next line from the reader, or <see langword="null" /> if all characters have been read.
Reads a line of characters from the text reader and returns the data as a string.
public
Threading.Tasks.Task`1
ReadLineAsync() Returns A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the next line from the text reader, or is <see langword="null" /> if all of the characters have been read.
Reads a line of characters asynchronously and returns the data as a string.
ReadLineAsync(Threading.CancellationToken cancellationToken)
cancellationToken
The token to monitor for cancellation requests.
Returns A value task that represents the asynchronous read operation. The value of the <c>TResult</c> parameter contains the next line from the text reader, or is <see langword="null" /> if all of the characters have been read.
Reads a line of characters asynchronously and returns the data as a string.
public
string
ReadToEnd() Returns A string that contains all characters from the current position to the end of the text reader.
Reads all characters from the current position to the end of the text reader and returns them as one string.
public
Threading.Tasks.Task`1
ReadToEndAsync() Returns A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains a string with the characters from the current position to the end of the text reader.
Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.
public
Threading.Tasks.Task`1
ReadToEndAsync(Threading.CancellationToken cancellationToken)
cancellationToken
The token to monitor for cancellation requests.
Returns A task that represents the asynchronous read operation. The value of the <c>TResult</c> parameter contains a string with the characters from the current position to the end of the text reader.
Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.
public
object
GetLifetimeService()
Inherited from MarshalByRefObject
Returns An object of type <see cref="T:System.Runtime.Remoting.Lifetime.ILease" /> used to control the lifetime policy for this instance.
Retrieves the current lifetime service object that controls the lifetime policy for this instance.
public
object
InitializeLifetimeService()
Inherited from MarshalByRefObject
Returns An object of type <see cref="T:System.Runtime.Remoting.Lifetime.ILease" /> used to control the lifetime policy for this instance. This is the current lifetime service object for this instance if one exists; otherwise, a new lifetime service object initialized to the value of the <see cref="P:System.Runtime.Remoting.Lifetime.LifetimeServices.LeaseManagerPollTime" /> property.
Obtains a lifetime service object to control the lifetime policy for this instance.
protected
MarshalByRefObject
MemberwiseClone(bool cloneIdentity)
Inherited from MarshalByRefObject
cloneIdentity
<see langword="false" /> to delete the current <see cref="T:System.MarshalByRefObject" /> object's identity, which will cause the object to be assigned a new identity when it is marshaled across a remoting boundary. A value of <see langword="false" /> is usually appropriate. <see langword="true" /> to copy the current <see cref="T:System.MarshalByRefObject" /> object's identity to its clone, which will cause remoting client calls to be routed to the remote server object.
Returns A shallow copy of the current <see cref="T:System.MarshalByRefObject" /> object.
Creates a shallow copy of the current <see cref="T:System.MarshalByRefObject" /> object.
public
bool
Equals(object obj)
Inherited from object
obj
The object to compare with the current object.
Returns <see langword="true" /> if the specified object is equal to the current object; otherwise, <see langword="false" /> .
Determines whether the specified object is equal to the current object.
protected
void
Finalize()
Inherited from object
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
public
int
GetHashCode()
Inherited from object
Returns A hash code for the current object.
Serves as the default hash function.
public
Type
GetType()
Inherited from object
Returns The exact runtime type of the current instance.
Gets the <see cref="T:System.Type" /> of the current instance.
protected
object
MemberwiseClone()
Inherited from object
Returns A shallow copy of the current <see cref="T:System.Object" /> .
Creates a shallow copy of the current <see cref="T:System.Object" /> .
public
string
ToString()
Inherited from object
Returns A string that represents the current object.
Returns a string that represents the current object.