• Article

BinaryReader.ReadChars Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Reads count characters from the current stream, returns the data in a character array, and advances the current position in accordance with the Encoding used and the specific character being read from the stream.

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

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Overridable Function ReadChars ( _
    count As Integer _
) As Char()

[SecuritySafeCriticalAttribute]
public virtual char[] ReadChars(
    int count
)

Parameters

  • count
    Type: System.Int32
    The number of characters to read.

Return Value

Type: array<System.Char[]
A character array containing data read from the underlying stream. This might be less than the number of characters requested if the end of the stream is reached.

Exceptions

Exception Condition
ObjectDisposedException

The stream is closed.
IOException

An I/O error occurs.
ArgumentOutOfRangeException

count is negative.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.