Stream.WriteByte Method
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)
Parameters
- value
- Type: System.Byte
The byte to write to the stream.
| 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. |
Use the CanWrite property to determine whether the current instance supports writing.
Notes to ImplementersThe 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.
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.