Freigeben über


Stream.ReadByte Methode

Definition

Liest ein Byte aus dem Datenstrom und wechselt die Position innerhalb des Datenstroms um ein Byte oder gibt -1 zurück, wenn am Ende des Datenstroms.

public:
 virtual int ReadByte();
public virtual int ReadByte();
abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int
Public Overridable Function ReadByte () As Integer

Gibt zurück

Das nicht signierte Byte wird in ein Int32, oder -1, wenn am Ende des Datenstroms.

Ausnahmen

Der Datenstrom unterstützt das Lesen nicht.

Methoden wurden aufgerufen, nachdem der Datenstrom geschlossen wurde.

Hinweise

Verwenden Sie die CanRead Eigenschaft, um zu ermitteln, ob die aktuelle Instanz das Lesen unterstützt.

Versuche, den Datenstrom zu bearbeiten, nachdem der Datenstrom geschlossen wurde, könnte einen Auslösen auslösen ObjectDisposedException.

Hinweise für Vererber

Die Standardimplementierung für Stream erstellt ein neues Single-Byte-Array und ruft dann auf Read(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 den Puffer direkt liest, sodass die zusätzliche Arrayzuordnung für jeden Aufruf vermieden wird.

Gilt für:

Weitere Informationen