Stream.WriteByte(Byte) Methode
Definition
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 in die aktuelle Position im Datenstrom und wechselt die Position innerhalb des Datenstroms 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 -> unitPublic Overridable Sub WriteByte (value As Byte)Parameter
- value
- Byte
Das Byte, das in den Datenstrom geschrieben werden soll.
Ausnahmen
Ein E/A-Fehler tritt auf.
Der Datenstrom unterstützt das Schreiben nicht, oder der Datenstrom ist bereits geschlossen.
Methoden wurden aufgerufen, nachdem der Datenstrom geschlossen wurde.
Hinweise
Verwenden Sie die CanWrite Eigenschaft, um zu bestimmen, ob die aktuelle Instanz 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). Obwohl dies formal korrekt ist, ist es ineffizient. 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 Arrayzuordnung für jeden Aufruf vermieden wird.
