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

Definition

Schreibt ein Byte an die aktuellen Position im Stream und erhöht die aktuelle Position im Stream um ein Byte.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)

Parameter

value
Byte Byte Byte Byte

Das Byte, das in den Stream geschrieben werden soll.The byte to write to the stream.

Ausnahmen

Ein E/A-Fehler tritt auf.An I/O error occurs.

Der Stream unterstützt keine Schreibvorgänge, oder er wurde bereits geschlossen.The stream does not support writing, or the stream is already closed.

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.Methods were called after the stream was closed.

Hinweise

Verwenden der CanWrite Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstützt.Use the CanWrite property to determine whether the current instance supports writing.

Hinweise für Vererber

Die Standardimplementierung für Stream erstellt ein neues Single-Byte-Array und ruft dann Write(Byte[], Int32, Int32).The default implementation on Stream creates a new single-byte array and then calls Write(Byte[], Int32, Int32). Während dies formell richtig ist, ist es ineffizient.While this is formally correct, it is inefficient. Jeder Stream mit einem internen Puffer sollte diese Methode überschreiben und bieten eine sehr viel effizientere Version, die direkt in den Puffer schreibt die zusätzlichen Array Zuordnung bei jedem Aufruf zu vermeiden.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.

Gilt für:

Siehe auch