Writes a byte to the current position in the stream and advances the position within the stream by one byte.
[Visual Basic] Public Overridable Sub WriteByte( _ ByVal value As Byte _ ) [C#] public virtual void WriteByte( byte value ); [C++] public: virtual void WriteByte( unsigned char value ); [JScript] public function WriteByte( value : Byte );
- The byte to write to the stream.
|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.|
For an example of creating a file and writing text to a file, see Writing Text to a File. For an example of reading text from a file, see Reading Text from a File. For an example of reading from and writing to a binary file, see Reading and Writing to a Newly Created Data File.
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 reads the buffer directly, avoiding the extra array allocation on every call.
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard