Stream.WriteByte(Byte) Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

IOException

Ein E/A-Fehler tritt auf.

NotSupportedException

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

ObjectDisposedException

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.

Hinweise

Verwenden Sie die CanWrite -Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibhilfen unterstützt.

Hinweise für Vererber

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

Gilt für