Stream.WriteByte(Byte) Stream.WriteByte(Byte) Stream.WriteByte(Byte) Stream.WriteByte(Byte) Method

Определение

Записывает байт в текущее положение в потоке и перемещает позицию в потоке вперед на один байт.Writes a byte to the current position in the stream and advances the position within the stream by one byte.

public:
 virtual void WriteByte(System::Byte value);
public virtual void WriteByte (byte value);
abstract member WriteByte : byte -> unit
override this.WriteByte : byte -> unit
Public Overridable Sub WriteByte (value As Byte)

Параметры

value
Byte Byte Byte Byte

Байт, записываемый в поток.The byte to write to the stream.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

Поток не поддерживает запись или был закрыт до начала операции.The stream does not support writing, or the stream is already closed.

Методы были вызваны после закрытия потока.Methods were called after the stream was closed.

Комментарии

Используйте CanWrite свойства, чтобы определить, поддерживает ли текущий экземпляр операции записи.Use the CanWrite property to determine whether the current instance supports writing.

Примечания для тех, кто наследует этот метод

Реализация по умолчанию в Stream создает новый массив однобайтовых, а затем вызывает Write(Byte[], Int32, Int32).The default implementation on Stream creates a new single-byte array and then calls Write(Byte[], Int32, Int32). Это формально верно, но неэффективно.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.

Применяется к

Дополнительно