Stream.WriteByte Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Writes a byte to the current position in the stream and advances the position within the stream by one byte.
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.