Stream.WriteByte(Byte) Methode

Definition

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

Das Byte, das in den Stream geschrieben werden soll.

Ausnahmen

Ein E/A-Fehler tritt auf.

Der Stream unterstützt keine Schreibvorgänge, oder er wurde bereits geschlossen.

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.

Hinweise

Verwenden Sie die CanWrite -Eigenschaft, um zu bestimmen, ob die aktuelle instance das Schreiben unterstützt.

Hinweise für Vererber

Die Standardimplementierung für Stream erstellt ein neues Single-Byte-Array und ruft dann auf Write(Byte[], Int32, Int32). Dies ist zwar formal korrekt, aber ineffizient. Jeder Stream mit einem internen Puffer sollte diese Methode überschreiben und eine viel effizientere Version bereitstellen, die direkt in den Puffer schreibt, wodurch die zusätzliche Arrayzuordnung bei jedem Aufruf vermieden wird.

Gilt für:

Weitere Informationen