Freigeben über


Stream.WriteByte Method

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

Writes a byte to the current position in the stream and advances the position within the stream by one byte.

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

Syntax

'Declaration
Public Overridable Sub WriteByte ( _
    value As Byte _
)
public virtual void WriteByte(
    byte value
)

Parameters

  • value
    Type: System.Byte
    The byte to write to the stream.

Exceptions

Exception Condition
IOException

An I/O error occurs.

NotSupportedException

The stream does not support writing, or the stream is already closed.

ObjectDisposedException

Methods were called after the stream was closed.

Remarks

Use the CanWrite property to determine whether the current instance supports writing.

Notes to Implementers

The default implementation on Stream creates a new single-byte array and then calls Write. While this is formally correct, it is inefficient. Any stream with an internal buffer should override this method and provide a much more efficient version that writes to the buffer directly, avoiding the extra array allocation on every call.

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.

See Also

Reference