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)

Parameters

value
Byte

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

Exceptions

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.

Remarks

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

Notes to Inheritors

Die Standard Implementierung auf Stream erstellt ein neues Einzel Byte Array und ruft dann Write(Byte[], Int32, Int32)auf.The default implementation on Stream creates a new single-byte array and then calls Write(Byte[], Int32, Int32). Obwohl dies formal korrekt ist, ist es ineffizient.While this is formally correct, it is inefficient. Jeder Datenstrom mit einem internen Puffer sollte diese Methode überschreiben und eine wesentlich effizientere Version bereitstellen, die direkt in den Puffer schreibt, sodass die zusätzliche Array Zuordnung bei jedem-Befehl vermieden wird.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.

Applies to

See also