Stream.WriteByte(Byte) Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Stream.cs

Quelle:: Stream.cs

Quelle:: Stream.cs

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 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: