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 Stream und erhöht die Position im Stream um ein Byte, oder gibt -1 zurück, wenn das Ende des Streams erreicht ist.
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 Byte ohne Vorzeichen, umgewandelt in Int32, oder -1, wenn das Ende des Streams erreicht ist.
Ausnahmen
Lesevorgänge werden vom Stream nicht unterstützt.
Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.
Hinweise
Verwenden Sie die CanRead -Eigenschaft, um zu bestimmen, ob die aktuelle instance Lesevorgänge unterstützt.
Versuche, den Stream zu bearbeiten, nachdem der Stream geschlossen wurde, können einen ObjectDisposedExceptionauslösen.
Hinweise für Vererber
Die Standardimplementierung für Stream
erstellt ein neues Einzelbytearray und ruft dann auf Read(Byte[], Int32, Int32). Dies ist zwar formal richtig, aber ineffizient. Jeder Stream mit einem internen Puffer sollte diese Methode außer Kraft setzen und eine viel effizientere Version bereitstellen, die den Puffer direkt liest, wodurch die zusätzliche Arrayzuordnung bei jedem Aufruf vermieden wird.