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.