Stream.ReadByte 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.
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.