StreamWriter.Write Method (Char)

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

Writes a character to the stream.

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

Syntax

Public Overrides Sub Write ( _
    value As Char _
)
public override void Write(
    char value
)

Parameters

Exceptions

Exception Condition
IOException

An I/O error occurs.

ObjectDisposedException

AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

NotSupportedException

AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Remarks

This method overrides TextWriter..::.Write.

The specified character is written to the underlying stream unless the end of the stream is reached prematurely. If AutoFlush is true, Flush is invoked automatically.

Version Notes

Windows Phone

StreamWriter..::.Write may throw IndexOutOfRangeException if the stream state becomes corrupted. In Windows Phone, the stream state may become corrupted if multiple threads write to or read from a stream object without using synchronization.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

StreamWriter Class

Write Overload

System.IO Namespace