BinaryWriter.Write Method (Char)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Writes a Unicode character to the current stream and advances the current position of the stream in accordance with the Encoding used and the specific characters being written to the stream.

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

Syntax

Public Overridable Sub Write ( _
    ch As Char _
)
public virtual void Write(
    char ch
)

Parameters

Exceptions

Exception Condition
IOException

An I/O error occurs.

ObjectDisposedException

The stream is closed.

ArgumentException

ch is a single surrogate character.

Remarks

Because of data formatting conflicts, using this method with the following encodings is not recommended:

  • UTF-7

  • ISO-2022-JP

  • ISCII

Unicode surrogate characters must be written out as pairs together in the same call, not individually. If you require support for surrogate pairs in your application, consider using a character array and the Write method overload.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

BinaryWriter Class

Write Overload

System.IO Namespace